1tin(5)                         Usenet newsreader                        tin(5)
2
3
4

NAME

6       tin, rtin - related files
7
8

DESCRIPTION

10       This  man  page  describes the various (config) files and their formats
11       used by the tin(1) newsreader. All files  are  expected  to  have  unix
12       style ('\n' aka LF) line endings.
13
14

FILES

16       $MAILCAPS
17       ~/.mailcap
18       /etc/mailcap
19       /usr/etc/mailcap
20       /usr/local/etc/mailcap
21       /etc/mail/mailcap
22
23              mailcap(5)  files  as  defined in RFC1524. The mailcap files are
24              read by tin(1) to determine how to display non-text messages  at
25              the  local  site.  Any  line  that starts with "#" is a comment.
26              Blank lines are ignored. Otherwise, each line defines  a  single
27              mailcap  entry for a single content type. Long lines may be con‐
28              tinued by ending them with a backslash character, "\".
29
30              Each individual mailcap entry consists of a content-type  speci‐
31              fication, a command to execute, and (possibly) a set of optional
32              "flag" values.
33
34              The "type" field is simply any legal content type  name.  It  is
35              the  string  that  will be matched against the ''Content-Type:''
36              header to decide if this is the mailcap entry that  matches  the
37              current message. Additionally, the type field may specify a sub‐
38              type or a wildcard to match all subtypes.
39
40              The "command" field is any UNIX command and is used  to  specify
41              the interpreter for the given type of message. It will be passed
42              to the shell via the system(3) facility.
43
44              Semicolons and backslashes within the command or any flag  field
45              must  be  quoted  with  backslashes. If the field contains "%s",
46              those two characters will be replaced by the name of a file that
47              contains the body of the message. If it contains "%t", those two
48              characters will be replaced by the content-type field, including
49              the subtype, if any. If it contains "%{" followed by a parameter
50              name and a closing  "}",  then  all  those  characters  will  be
51              replaced  by  the value of the named parameter, if any, from the
52              ''Content-Type:'' header. Finally, if the field  contains  "\%",
53              those two characters will be replaced by a single "%" character.
54
55              Besides  the  type  and  command field the following "flags" are
56              defined:
57
58              compose
59                     The "compose" field may be used to specify a program that
60                     can  be  used  to  compose a new body or body part in the
61                     given format. Its intended use is to support mail compos‐
62                     ing agents that support the composition of multiple types
63                     of mail using external  composing  agents.  As  with  the
64                     view-command,  the  semantics  of  program  execution are
65                     operating system dependent. The result of  the  composing
66                     program  may  be  data  that is not yet suitable for mail
67                     transport — that is, a Content-Transfer-Encoding may need
68                     to be applied to the data.
69
70              composetyped
71                     The  "composetyped"  field  is  similar  to the "compose"
72                     field, but is to be used when the composing program needs
73                     to  specify  the  ''Content-Type:''  header  field  to be
74                     applied to the composed data. The "compose" field is sim‐
75                     pler,  and  is preferred for use with existing (non-mail-
76                     oriented) programs for composing data in a given  format.
77                     The  "composetyped"  field  is  necessary  when  the Con‐
78                     tent-Type information must include auxiliary  parameters,
79                     and  the  composition program must then know enough about
80                     mail formats to produce output  that  includes  the  mail
81                     type information.
82
83              edit   The  "edit"  field  may be used to specify a program that
84                     can be used to edit a body or body part in the given for‐
85                     mat. In many cases, it may be identical in content to the
86                     "compose" field, and shares the  operating-system  depen‐
87                     dent semantics for program execution.
88
89              print  The  "print"  field may be used to specify a program that
90                     can be used to print a message or body part in the  given
91                     format.  As  with the view-command, the semantics of pro‐
92                     gram execution are operating system dependent.
93
94              test   The "test" field may be used to test some external condi‐
95                     tion  (e.g., the machine architecture, or the window sys‐
96                     tem in use) to determine whether or not the mailcap  line
97                     applies.  It  specifies  a program to be run to test some
98                     condition. The semantics of execution and  of  the  value
99                     returned  by the test program are operating system depen‐
100                     dent. If the  test  fails,  a  subsequent  mailcap  entry
101                     should  be sought. Multiple test fields are not permitted
102                     — since a test can call a  program,  it  can  already  be
103                     arbitrarily complex.
104
105              needsterminal
106                     The "needsterminal" field indicates that the view-command
107                     must be run on an interactive terminal. This is needed to
108                     inform  window-oriented  user  agents that an interactive
109                     terminal is needed. (The decision is not left exclusively
110                     to  the view-command because in some circumstances it may
111                     not be possible for such programs to tell whether or  not
112                     they  are  on  interactive  terminals.) The needsterminal
113                     command should be assumed to apply  to  the  compose  and
114                     edit  commands, too, if they exist. Note that this is NOT
115                     a test - it is a requirement for the environment in which
116                     the  program will be executed, and should typically cause
117                     the creation of a terminal window when  not  executed  on
118                     either a real terminal or a terminal window.
119
120              copiousoutput
121                     The  "copiousoutput" field indicates that the output from
122                     the view-command will be an extended  stream  of  output,
123                     and  is to be interpreted as advice to the UA (User Agent
124                     mail-reading program) that the output  should  be  either
125                     paged  or  made  scroll-able.  Note that it is probably a
126                     mistake if needsterminal and copiousoutput are both spec‐
127                     ified.
128
129              description
130                     The   "description"   field  simply  provides  a  textual
131                     description, optionally quoted, that describes  the  type
132                     of  data, to be used optionally by mail readers that wish
133                     to describe the data before offering to display it.
134
135              textualnewlines
136                     The "textualnewlines"  field,  if  set  to  any  non-zero
137                     value,  indicates that this type of data is line-oriented
138                     and that, if encoded in base64, all  newlines  should  be
139                     converted  to  canonical form (CRLF) before encoding, and
140                     will be in that form after  decoding.  In  general,  this
141                     field  is  needed  only if there is line-oriented data of
142                     some type other than text/* or  non-line-  oriented  data
143                     that is a subtype of text.
144
145              x11-bitmap
146                     The  "x11-bitmap" field names a file, in X11 bitmap (xbm)
147                     format, which points to an appropriate icon to be used to
148                     visually denote the presence of this kind of data.
149
150              nametemplate
151                     The  "nametemplate"  field  gives  a  filename format, in
152                     which %s will be replaced by a  short  unique  string  to
153                     give  the  name of the temporary file to be passed to the
154                     viewing command. This is only expected to be relevant  in
155                     environments  where  filename  extensions are meaningful,
156                     e.g., one could specify that a GIF file being passed to a
157                     gif  viewer  should have a name ending in ".gif" by using
158                     "nametemplate=%s.gif"
159
160              tin(1) currently only respects the "test", "description", "name‐
161              template"  and partly the "needsterminal" flags, all other flags
162              are internally ignored. It also can't handle the "%F"  and  "%n"
163              expansions yet.
164
165              Example:
166                     # mailcap file example
167                     image/*;\
168                        xv -8 -geometry +0 '%s';\
169                        description=%{name} %t-Image;\
170                        test=test "$DISPLAY" != "";\
171                        nametemplate=%s.IMAGE
172
173                     message/rfc822;\
174                        ${PAGER:-"more"} '%s';\
175                        edit=${EDITOR:-"vi"} '%s';\
176                        compose=${EDITOR:-"vi"} '%s';\
177                        print=a2ps '%s';\
178                        needsterminal
179
180       /etc/nntpserver
181
182              default  NNTP-server  to  read news from if not reading from the
183              local spool.  '-g server', $NNTPSERVER have higher priority  (in
184              that  order), the default server given at compile time has lower
185              priority.
186
187       ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
188
189              secret to be used for cancel-locks if tin(1) is build with  sup‐
190              port  for it. An empty secret file disables the cancel-lock cre‐
191              ation in that case. This file should be  readable  only  by  the
192              user.
193
194       ${TIN_HOMEDIR:-"$HOME"}/.mime.types
195       /etc/mime.types
196       /etc/tin/mime.types
197
198              mime type / filename extension pairs
199
200       ${TIN_HOMEDIR:-"$HOME"}/.newsauth
201
202              "nntpserver password [user]" pairs for NNTP servers that require
203              authorization. If the password contains a space or a tab it must
204              be enclosed in double quotes ("). Usernames must not be enclosed
205              in double quotes and thus can't contain spaces or tabs. Any line
206              that starts with "#" is a comment. Blank lines are ignored. This
207              file should be readable only for the user  as  it  contains  the
208              user's unencrypted password for reading news!
209
210              nntpserver
211                     full qualified domain name of the news server.
212
213              password
214                     user's unencrypted password for reading news.
215
216              user   username  on the news server if it differs from the local
217                     login. This field is optional.
218
219              Example:
220                     # sample .newsauth file
221                     news.example.org  secret
222                     news.example.net  arcane  guest
223                     news.example.com  "top secret"  james.bond@example.com
224
225       ${TIN_HOMEDIR:-"$HOME"}/.newsrc
226
227              "newsgroupflag [article[,article | -article]...]" lines.
228
229              newsgroup
230                     the name of the newsgroup.
231
232              flag   a flag indicating if the group is subscribed ':'  or  not
233                     '!'.
234
235              article
236                     range  of  already read articles from that group; numbers
237                     separated by commas  with  sequential  numbers  collapsed
238                     with hyphens.
239
240              Example:
241                     # sample .newsrc file
242                     news.software.b! 1-666,669
243                     news.software.nntp: 1-13245,13247,13249
244                     news.software.readers: 1-19567,19571-19597
245
246       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
247
248              backup of ${TIN_HOMEDIR:-"$HOME"}/.newsrc
249
250       ${TIN_HOMEDIR:-"$HOME"}/.signature
251       ${TIN_HOMEDIR:-"$HOME"}/.Sig
252
253              signature
254
255       ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
256
257              fixed part of a randomly generated signature
258
259       ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
260
261              history of last used strings
262
263       ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
264
265              mailgroups index files
266
267       ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
268
269              newsgroups index files
270
271       ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
272
273              saved newsgroups index files
274
275       ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
276
277              active  file  ("mail_group_name maxnum minnum mailspool" quadru‐
278              ples) of user's mailgroups (requires tin(1) to be build with mh-
279              mail-handling support).
280
281              mail_group_name
282                     must  be the pathname of the mailbox relative to field #4
283                     with / changed to .
284
285              maxnum just put a large number here, something higher  than  the
286                     highest message in the mailbox
287
288              minnum put 0 here
289
290              mailspool
291                     path of mail spool directory. This must be the full path‐
292                     name to the root of the mail folder area.
293
294              Example:
295                     Mail.inbox  12345 00000 /home/foo
296                     Mail.outbox 23456 00000 /home/foo
297
298              This allows access to the 'inbox' and 'outbox' folders  of  user
299              foo.    They   are   accessed   via   /home/foo/Mail/inbox   and
300              /home/foo/Mail/outbox
301
302       ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
303
304              active file of user's saved newsgroups, used by tin -R.
305
306       /etc/tin/attributes
307       ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
308
309              The group attributes files may be used to override  some  global
310              settings  from ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc on a per group
311              basis. Order is important as last match counts; this allows  one
312              to   refine  attributes  for  narrowed  scopes.  Note  that  the
313              scope=<grouplist> line has to be specified before the attributes
314              are  specified  for that list and each attribute can only be set
315              once per scope section. All attributes are set to  a  reasonable
316              default  so you only have to specify the attribute that you want
317              to change. All toggle attributes are set by  specifying  ON/OFF.
318              Otherwise,  they  function  exactly as their global equivalents.
319              The following group attributes are available:
320
321              scope  This changes the list of groups to which  the  attributes
322                     that  follow  will  be applied. See the section NEWSGROUP
323                     LISTS & WILDCARDS in tin(1) for the types of pattern that
324                     can be used here.
325
326              add_posted_to_filter
327                     Identical to the tinrc variable of the same name
328
329              advertising
330                     Identical to the tinrc variable of the same name
331
332              alternative_handling
333                     Identical to the tinrc variable of the same name
334
335              ask_for_metamail
336                     Identical to the tinrc variable of the same name
337
338              auto_cc_bcc
339                     Identical to the tinrc variable of the same name
340
341              auto_list_thread
342                     Identical to the tinrc variable of the same name
343
344              auto_save
345                     Identical to the tinrc variable of the same name
346
347              auto_select
348                     Automatically  perform  the  GroupMarkUnselArtRead  ('X')
349                     command after entering the group.
350
351              batch_save
352                     Can be used to override the global setting in tinrc on  a
353                     per  group basis. For more information read section AUTO‐
354                     MATIC MAILING AND SAVING NEW NEWS in tin(1).
355
356              date_format
357                     Identical to the tinrc variable of the same name
358
359              delete_tmp_files
360                     If this is set to ON, then saved article files that  have
361                     been post-processed will be automatically deleted, other‐
362                     wise the user will be asked whether to delete  the  post-
363                     processed  files. Automatic processing of marked articles
364                     using GroupAutoSave ('S') will suppress prompting.
365
366              editor_format
367                     Identical to the tinrc variable of the same name
368
369              extquote_handling
370                     Identical to the tinrc variable of the same name
371
372              fcc    Mailbox to save sent mails. The format of the mailbox  is
373                     controlled via the tinrc mailbox_format variable.
374
375              followup_to
376                     Set ''Followup-To:'' header to the specified group(s).
377
378              from   Identical to the tinrc variable mail_address
379
380              group_catchup_on_exit
381                     Identical to the tinrc variable of the same name
382
383              group_format
384                     Identical to the tinrc variable of the same name
385
386              mail_8bit_header
387                     Identical to the tinrc variable of the same name
388
389              mail_mime_encoding
390                     Identical to the tinrc variable of the same name
391
392              maildir
393                     Identical to the tinrc variable of the same name
394
395              mailing_list
396                     Used when a group is a mailing list. All responses to the
397                     group will be directed to this email address instead
398
399              mark_ignore_tags
400                     Identical to the tinrc variable of the same name
401
402              mark_saved_read
403                     Identical to the tinrc variable of the same name
404
405              mime_forward
406                     Determines  whether  usenet  articles  are  forwarded  as
407                     attachment  or  inline.  When  set  to OFF, the forwarded
408                     article will be included in the body of the  mail,  while
409                     setting  this variable to ON will cause the article to be
410                     attached as a separate MIME part.  Enabling  mime_forward
411                     is  particularly useful for articles consisting of multi‐
412                     ple MIME parts such as PGP/MIME signed messages or  being
413                     encoded in a different character set than your local one.
414                     It is also useful if the receiver should be able to oper‐
415                     ate  on  the entire forwarded article (i.e., view or save
416                     it without your comments). On the other hand, if you want
417                     to  forward  only  some parts of the article or to insert
418                     'inline' annotations, you  might  want  to  disable  this
419                     option.   Currently mime_forward is forced if the article
420                     to be attached is a  multipart  MIME  article,  this  may
421                     change  in  a  future version.  Please note that for this
422                     option  to  have  effect,  the  tinrc  variable  interac‐
423                     tive_mailer has to be set to 0 (which is the default).
424
425              mime_types_to_save
426                     A  comma separated list of MIME major/minor Content-Types
427                     that  will  be  saved  when  using  the   view/save   and
428                     save/autosave  features.  A single * can be used to wild‐
429                     card the major and/or minor type and a  !  as  the  first
430                     character    in    an   entry   will   negate   it,   eg:
431                     image/*,!image/bmp,!text/html. Default is */*
432
433              news_headers_to_display
434                     Identical to the tinrc variable of the same name
435
436              news_headers_to_not_display
437                     Identical to the tinrc variable of the same name
438
439              news_quote_format
440                     Identical to the tinrc variable of the same name
441
442              organization
443                     This can be used to set the article header field  ''Orga‐
444                     nization:''. It overrides the setting (if any) of organi‐
445                     zation in  /etc/tin/tin.defaults  and  $ORGANIZATION  (or
446                     $NEWSORG on Apollo DomainOS). Note that some news servers
447                     might still overwrite the ''Organization:'' header.
448
449              pos_first_unread
450                     Identical to the tinrc variable of the same name
451
452              post_8bit_header
453                     Identical to the tinrc variable of the same name
454
455              post_mime_encoding
456                     Identical to the tinrc variable of the same name
457
458              post_process_type
459                     Identical to the tinrc variable of the same name
460
461              post_process_view
462                     Identical to the tinrc variable of the same name
463
464              print_header
465                     Identical to the tinrc variable of the same name
466
467              process_only_unread
468                     Identical to the tinrc variable of the same name
469
470              prompt_followupto
471                     Identical to the tinrc variable of the same name
472
473              quote_chars
474                     Identical to the tinrc variable of the same name
475
476              savedir
477                     Identical to the tinrc variable of the same name
478
479              savefile
480
481              show_author
482                     Identical to the tinrc variable of the same name
483
484              show_info
485                     Identical to the tinrc variable of the same name
486
487              show_only_unread_arts
488                     Identical to the tinrc variable of the same name
489
490              show_signatures
491                     Identical to the tinrc variable of the same name
492
493              sigdashes
494                     Identical to the tinrc variable of the same name
495
496              sigfile
497                     Identical to the tinrc variable of the same name
498
499              signature_repost
500                     Identical to the tinrc variable of the same name
501
502              sort_article_type
503                     Identical to the tinrc variable sort_article_type
504
505              sort_threads_type
506                     Identical to the tinrc variable of the same name
507
508              start_editor_offset
509                     Identical to the tinrc variable of the same name
510
511              tex2iso_conv
512                     Identical to the tinrc variable of the same name
513
514              thread_articles
515                     Identical to the tinrc variable of the same name
516
517              thread_catchup_on_exit
518                     Identical to the tinrc variable of the same name
519
520              thread_format
521                     Identical to the tinrc variable of the same name
522
523              thread_perc
524                     Identical to the tinrc variable of the same name
525
526              trim_article_body
527                     Identical to the tinrc variable of the same name
528
529              verbatim_handling
530                     Identical to the tinrc variable of the same name
531
532              wrap_on_next_unread
533                     Identical to the tinrc variable of the same name
534
535              x_body A piece of text that will be added at the start of a mes‐
536                     sage body. If this string starts with a / or ~ then it is
537                     assumed to be the name of a file containing the  text  to
538                     insert.
539
540              x_comment_to
541                     Insert  ''X-Comment-To:''  header, this is only useful in
542                     FIDO groups.
543
544              x_headers
545                     A string including header-name and the  contents  of  the
546                     header  that will be automatically added when posting. If
547                     the string starts with a / or ~ then it is assumed to  be
548                     the  name of a file containing the header and its content
549                     to be inserted. If the string starts with a !  then  what
550                     follows is assumed to be the path to a program to be exe‐
551                     cuted to generate the  header  and  its  content.  %G  is
552                     expanded   to  the  current  news.group.name  and  %P  is
553                     expanded to the news.group.name with all '.' replaced  by
554                     '/'.
555
556              quick_kill_scope
557                     A  comma-separated  list  of newsgroup patterns (wildmat-
558                     style) to which groups the filter rule added by QuickFil‐
559                     terKill  will  be applied.  If unset the default from the
560                     tinrc variable default_filter_kill_global will be used.
561
562              quick_kill_expire
563                     Identical   to   the    tinrc    variable    default_fil‐
564                     ter_kill_expire
565
566              quick_kill_case
567                     Identical to the tinrc variable default_filter_kill_case
568
569              quick_kill_header
570                     Identical    to    the    tinrc   variable   default_fil‐
571                     ter_kill_header
572
573              quick_select_scope
574                     A comma-separated list of  newsgroup  patterns  (wildmat-
575                     style) to which groups the filter rule added by QuickFil‐
576                     terSelect will be applied. If unset the default from  the
577                     tinrc variable default_filter_select_global will be used.
578
579              quick_select_expire
580                     Identical    to    the    tinrc   variable   default_fil‐
581                     ter_select_expire
582
583              quick_select_case
584                     Identical   to   the    tinrc    variable    default_fil‐
585                     ter_select_case
586
587              quick_select_header
588                     Identical    to    the    tinrc   variable   default_fil‐
589                     ter_select_header
590
591              ispell Path and options for ispell(1)-like  spell-checker,  e.g.
592                     "aspell --mode=email --dont-backup check"
593
594              mm_network_charset
595                     Identical to the tinrc variable of the same name
596
597              undeclared_charset
598                     Assume (broken) articles without MIME charset declaration
599                     have this charset — default is US-ASCII.  This  attribute
600                     works only on systems with working iconv(3), others might
601                     have     to     compile      tin(1)      with      --dis‐
602                     able-mime-strict-charset.
603
604              Example:
605                     # include extra headers
606                     # assume ISO-8859-1 as charset if no charset is declared
607                     scope=*
608                     x_headers=~/.tin/headers
609                     undeclared_charset=ISO-8859-1
610
611                     # in *sources* set post process type to shar only
612                     scope=*sources*
613                     post_process_type=1
614
615                     # in *binaries* turn on full post processing,
616                     # remove tmp files and set Followup-To: poster
617                     scope=*binaries*
618                     post_process_type=2
619                     delete_tmp_files=ON
620                     followup_to=poster
621
622                     # in fido.* newsgroups change quote_chars
623                     # and add X-Comment-To: line
624                     scope=fido.*
625                     quote_chars=%I>_
626                     x_comment_to=ON
627
628                     # in *.test newsgroups, don't append signature
629                     # and preset Subject
630                     scope=*.test
631                     sigfile=--none
632                     x_headers=Subject: test - ignore - no reply
633
634                     # assume ISO-2022-JP-2 as charset
635                     scope=fj.*,japan.*
636                     undeclared_charset=ISO-2022-JP-2
637
638       ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
639
640              The  filter  file  is used to assign scores to certain articles.
641              Based on the score an article can be filtered  out  (hidden)  or
642              marked  hot.  Empty  lines  or  lines  beginning  with a '#' are
643              ignored.
644
645              comment
646                     Every entry (rule) in the filter file might  get  a  com‐
647                     ment.  Multiple  lines are allowed (but only for comments
648                     yet). Every line must start with the "comment="  keyword.
649                     Comments  must  appear  first in the rule.  Comment lines
650                     placed within a rule will be moved to the  begin  of  the
651                     next rule. This might be changed in the future. Don't use
652                     '#' to mark comments as those lines are ignored and  your
653                     comments will get lost on the next write of the file.
654
655              group  A  comma-separated  list  of newsgroup patterns (wildmat-
656                     style) to which groups the filter rule will  be  applied.
657                     This line is mandatory!
658
659              case   0=case-sensitive, 1=case-insensitive
660
661              score  Score  value  of  the  rule; can also be one of the magic
662                     words "kill" or "hot".
663
664              subj   Match against ''Subject:''
665
666              from   Match against ''From:''.  tin(1) converts the contents of
667                     the ''From:'' header to an old style e-mail address, e.g.
668                     ''some@body.example (John Doe)'' instead  of  ''John  Doe
669                     <some@body.example>'',  before  trying  to match the pat‐
670                     terns in the filter rule.
671
672              msgid  Match against ''Message-ID:'' and full ''References:''
673
674              msgid_last
675                     Match against ''Message-ID:''  and  last  ''References:''
676                     entry only
677
678              msgid_only
679                     Match against ''Message-ID:''
680
681              refs_only
682                     Match against ''References:''
683
684              lines  Match  against  ''Lines:'',  <num matches less than, >num
685                     matches more than.
686
687              gnksa  Match against ''From:'' address parser return codes.
688
689              xref   Match against ''Xref:'' line. Before any matching is done
690                     the  line  is turned into the same format ''Newsgroups:''
691                     has that is it is turned into a comma separated newsgroup
692                     list  with  all  other  information  (i.e.   the  article
693                     counter) removed.
694
695              path   Match against ''Path:'' line. This may not work  on  some
696                     servers.
697
698              time   time_t value when rule expires
699
700              Example:
701                     comment=mark all articles about tin, rtin,
702                     comment=tind, ktin or cdtin as hot
703                     group=*
704                     case=1
705                     score=hot
706                     subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
707
708       /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
709       ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
710
711              Keymap-file,  containing "keyname value [value]" pairs separated
712              by spaces or tabs. Below is a list of  all  rebindable  keynames
713              and  their  defaults.  If a keyname is bound to NULL it is unas‐
714              signed.
715
716              ShellEscape                    !
717              SetRange                       #
718              LastPage                       $
719              ToggleColor                    &
720              LastViewed                     -
721              SearchRepeat                   \
722              SearchSubjF                    /
723              SearchSubjB                    ?
724              SearchAuthB                    A
725              SearchBody                     B
726              CatchupNextUnread              C
727              EditFilter                     E
728              ToggleHelpDisplay              H
729              ToggleInverseVideo             I
730              LookupMessage                  L
731              OptionMenu                     M
732              Postponed                      O    ^O
733              QuitTin                        Q
734              BugReport                      R
735              DisplayPostHist                W
736              MarkThrUnread                  Z
737              FirstPage                      ^
738              SearchAuthF                    a
739              Catchup                        c
740              Help                           h
741              ToggleInfoLastLine             i
742              Down                           j    ^N
743              Up                             k    ^P
744              Print                          o
745              Quit                           q
746              Version                        v
747              Post                           w
748              MarkArtUnread                  z
749              QuickFilterSelect              [
750              QuickFilterKill                ]
751              Pipe                           |
752              ScrollUp                       <
753              ScrollDown                     >
754              PageUp                         b    ^B   ^U
755              PageDown                       ^D   ^F   SPACE
756              RedrawScr                      ^L
757              Postponed                      ^O
758              MenuFilterSelect               ^A
759              MenuFilterKill                 ^K
760              MarkFeedRead                   ^X
761              MarkFeedUnread                 ^W
762
763              AttachSelect                   ^J   ^M
764              AttachPipe                     p
765              AttachSave                     s
766              AttachTag                      t
767              AttachUntag                    U
768              AttachTagPattern               =
769              AttachToggleTagged             @
770
771              ConfigToggleAttrib             TAB
772              ConfigSelect                   ^J   ^M
773              ConfigLastPage                 G
774              ConfigNoSave                   Q
775              ConfigScopeMenu                S
776              ConfigFirstPage                g
777              ConfigResetAttrib              r
778
779              FeedTag                        T
780              FeedArt                        a
781              FeedHot                        h
782              FeedPat                        p
783              FeedRepost                     r
784              FeedSupersede                  s
785              FeedThd                        t
786
787              FilterEdit                     e
788              FilterSave                     s
789
790              GroupNextUnreadArtOrGrp        TAB
791              GroupReadBasenote              ^J   ^M
792              GroupSelThd                    *
793              GroupDoAutoSel                 +
794              GroupToggleThdSel              .
795              GroupSelThdIfUnreadSelected    ;
796              GroupSelPattern                =
797              GroupReverseSel                @
798              GroupCancel                    D
799              GroupToggleGetartLimit         G
800              GroupMarkThdRead               K
801              GroupNextUnreadArt             N
802              GroupPrevUnreadArt             P
803              GroupAutoSave                  S
804              GroupTagParts                  T
805              GroupUntag                     U
806              GroupMarkUnselArtRead          X
807              GroupToggleSubjDisplay         d
808              GroupGoto                      g
809              GroupListThd                   l
810              GroupMail                      m
811              GroupNextGroup                 n
812              GroupPrevGroup                 p
813              GroupToggleReadUnread          r
814              GroupSave                      s
815              GroupTag                       t
816              GroupToggleThreading           u
817              GroupRepost                    x
818              GroupUndoSel                   ~
819
820              HelpLastPage                   G
821              HelpFirstPage                  g
822
823              PageReplyQuoteHeaders          ^E
824              PagePGPCheckArticle            ^G
825              PageToggleRaw                  ^H
826              PageNextUnread                 TAB
827              PageNextThd                    ^J   ^M
828              PageToggleTabs                 ^T
829              PageFollowupQuoteHeaders       ^W
830              PageToggleTex2iso              "
831              PageToggleAllHeaders           *
832              PageToggleRot                  %
833              PageToggleUue                  (
834              PageReveal                     )
835              PageSkipIncludedText           :
836              PageTopThd                     <
837              PageBotThd                     >
838              PageCancel                     D
839              PageFollowup                   F
840              PageLastPage                   G
841              PageKillThd                    K
842              PageNextUnreadArt              N
843              PagePrevUnreadArt              P
844              PageReply                      R
845              PageAutoSave                   S
846              PageGroupSel                   T
847              PageViewUrl                    U
848              PageViewAttach                 V
849              PageToggleHighlight            _
850              PageEditArticle                e
851              PageFollowupQuote              f
852              PageFirstPage                  g
853              PageListThd                    l
854              PageMail                       m
855              PageNextArt                    n
856              PagePrevArt                    p
857              PageReplyQuote                 r
858              PageSave                       s
859              PageTag                        t
860              PageGotoParent                 u
861              PageRepost                     x
862
863              PgpEncSign                     b
864              PgpEncrypt                     e
865              PgpIncludekey                  i
866              PgpSign                        s
867
868              PostAbort                      a
869              PostContinue                   c
870              PostCancel                     d
871              PostEdit                       e
872              PostPGP                        g
873              PostIspell                     i
874              PostIgnore                     i
875              PostMail                       m
876              PostPostpone                   o
877              PostPost                       p    y
878              PostSupersede                  s
879              PostSend                       s    y
880
881              PostponeOverride               Y
882              PostponeAll                    A
883
884              PromptYes                      y    Y
885              PromptNo                       n    N
886
887              SaveAppendFile                 a
888              SaveOverwriteFile              o
889
890              PProcNone                      n
891              PProcShar                      s
892              PProcYes                       y
893
894              SelectEnterNextUnreadGrp       TAB  n
895              SelectReadGrp                  ^J   ^M
896              SelectResetNewsrc              ^R
897              SelectSortActive               .
898              SelectNextUnreadGrp            N
899              SelectSubscribePat             S
900              SelectUnsubscribePat           U
901              SelectQuitNoWrite              X
902              SelectSyncWithActive           Y
903              SelectToggleDescriptions       d
904              SelectGoto                     g
905              SelectMoveGrp                  m
906              SelectToggleReadDisplay        r
907              SelectSubscribe                s
908              SelectUnsubscribe              u
909              SelectYankActive               y
910              SelectMarkGrpUnread            z    Z
911
912              ScopeSelect                    ^J   ^M
913              ScopeEditAttributesFile        E
914              ScopeAdd                       a
915              ScopeDelete                    d
916              ScopeMove                      m
917              ScopeRename                    r
918
919              ThreadReadNextArtOrThread      TAB
920              ThreadReadArt                  ^J   ^M
921              ThreadSelArt                   *
922              ThreadToggleArtSel             .
923              ThreadReverseSel               @
924              ThreadCancel                   D
925              ThreadMarkArtRead              K
926              ThreadAutoSave                 S
927              ThreadUntag                    U
928              ThreadToggleSubjDisplay        d
929              ThreadMail                     m
930              ThreadSave                     s
931              ThreadTag                      t
932              ThreadUndoSel                  ~
933
934              UrlSelect                      ^J   ^M
935
936       ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
937
938              This  file  provides  short  descriptions  of  each   mailgroup.
939              (requires  tin(1)  to  be  build with mh-mail-handling support).
940              Each line consist of  two  tab-separated  fields  "mailgroupname
941              one-line description".
942
943              mailgroupname
944                     is the name of the newsgroup
945
946              description
947                     is a short single-line description of the group
948
949       ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
950
951              "nntpserver  newsrc  [shortname  [...]]"   pairs to use with the
952              ''-g'' command-line switch.
953
954              nntpserver
955                     full qualified domain name of the news server.
956
957              newsrc related newsrc.
958
959              shortname
960                     nickname(s) for the nntpserver.
961
962              Example:
963                     # sample newsrctable file
964                     news.tin.org .newsrc-tin.org tinorg
965                     news.example.org /tmp/nrc-ex example ex
966
967       ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
968
969              posting history
970
971       ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
972
973              Copy of all posted articles in mbox(5) format. The filename  can
974              be changed by setting posted_articles_file.
975
976       ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
977
978              Pool of postponed articles. This file is in mbox(5) format.
979
980       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/newsgroups
981
982              This  file  a copy of the servers newsgroups file which provides
983              short  descriptions  of  each  newsgroup.  It  is  automatically
984              updated  on  startup  except when using the ''-X''or ''-q'' com‐
985              mand-line option and an old copy exists. Each  line  consist  of
986              two tab-separated fields "group.name                    one-line
987              description".
988
989              group.name
990                     is the name of the newsgroup
991
992              one-line description
993                     is a short single-line description of the group
994
995       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/serverrc
996
997              File to store $NNTPSERVER and $NNTPPORT related data via a  list
998              of  "variable=value"  pairs.  Currently there are only two vari‐
999              ables, both are not meant to be changed by the user.
1000
1001              version
1002                     Internal version number.
1003
1004              last_newnews
1005                     Internal timestamp used by tin(1) to keep  track  of  new
1006                     newsgroups on the server.
1007
1008       /etc/tin/tinrc
1009       ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
1010
1011              At  startup,  tin(1)  reads in the configuration file. This con‐
1012              tains a list of "variable=value" pairs that can be used to  con‐
1013              figure the way tin(1) works. If it exists, the global configura‐
1014              tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first.  After
1015              that,    the   user's   own   configuration   file   ${TIN_HOME‐
1016              DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful  for
1017              distributing  system-wide defaults to new users who have no pri‐
1018              vate tinrc yet (see also /etc/tin/tin.defaults).
1019
1020              abbreviate_groupname
1021                     If ON abbreviate long newsgroup names at group  selection
1022                     level   and  article  level  (if  necessary)  like  this:
1023                     news.software.readers -> n.software.readers ->  n.s.read‐
1024                     ers -> n.s.r.  Default is OFF.
1025
1026              add_posted_to_filter
1027                     If  ON  add  posted  articles which start a new thread to
1028                     filter for highlighting follow-ups. Default is ON.
1029
1030              advertising
1031                     Turn ON advertising in header (''User-Agent:'').  Default
1032                     is ON.
1033
1034              alternative_handling
1035                     If ON strip multipart/alternative messages automatically.
1036                     Default is ON.
1037
1038              art_marked_deleted
1039                     The character used to show that an article  was  deleted.
1040                     Default is 'D'.
1041
1042              art_marked_inrange
1043                     The character used to show that an article is in a range.
1044                     Default is '#'.
1045
1046              art_marked_return
1047                     The character used to show that an article will return as
1048                     an unread article when the group is next entered. Default
1049                     is '-'.
1050
1051              art_marked_selected
1052                     The character used to  show  that  an  article/thread  is
1053                     auto-selected (hot).  Default is '*'.
1054
1055              art_marked_recent
1056                     The  character  used  to  show  that an article/thread is
1057                     recent (not older than X  days).  See  also  recent_time.
1058                     Default is 'o'.
1059
1060              art_marked_unread
1061                     The  character  used to show that an article has not been
1062                     read.  Default is '+'.
1063
1064              art_marked_read
1065                     The character used to show  that  an  article  was  read.
1066                     Default is ' '.
1067
1068              art_marked_killed
1069                     The  character  used  to show that an article was killed.
1070                     Default is 'K'.  kill_level must be set accordingly.
1071
1072              art_marked_read_selected
1073                     The character used to show that an article was hot before
1074                     it  was  read.   Default  is  ':'. kill_level must be set
1075                     accordingly.
1076
1077              Ask before using MIME viewer (ask_for_metamail)
1078                     If ON tin(1) will ask before using a MIME  viewer  (meta‐
1079                     mail_prog)  to display MIME messages. This only occurs if
1080                     a MIME viewer is set. Default is OFF.
1081
1082              auto_cc_bcc
1083                     Automatically  put  your  name  in  the  ''Cc:''   and/or
1084                     ''Bcc:'' field when mailing an article. Default is No.
1085
1086              auto_list_thread
1087                     If  ON  automatically  list thread when entering it using
1088                     right arrow key.  Default is ON.
1089
1090              auto_reconnect
1091                     Reconnect to server automatically. Default is OFF.
1092
1093              auto_save
1094                     If ON articles/threads with ''Archive-name:''  in  header
1095                     will  be  automatically  saved  with  the  Archive-name &
1096                     part/patch no and post processed if post_process_type  is
1097                     set to something other than 'No'.  Default is OFF.
1098
1099              batch_save
1100                     If  set  ON  articles/threads will be saved in batch mode
1101                     when save ''-S'' or mail ''-M, -N'' is specified  on  the
1102                     command line. Default is ON.
1103
1104              beginner_level
1105                     If set ON a mini menu of the most useful commands will be
1106                     displayed at the bottom of the  screen  for  each  level.
1107                     Also  a  short  posting etiquette will be displayed after
1108                     composing an article. Default is ON.
1109
1110              cache_overview_files
1111                     If ON, create local copies of NNTP overview  files.  This
1112                     can  be  used  to  considerably  speed up accessing large
1113                     groups when using a slow connection.  Default is OFF.
1114
1115              cancel_lock_algo
1116                     Use this hash algorithm for cancel-locks. Only  available
1117                     when  build  with  cancel-lock support. none disables the
1118                     generation of cancel-locks. Valid values are none,  sha1,
1119                     sha256 and sha512.  Default is sha1.
1120
1121              catchup_read_groups
1122                     If  set  ON the user is asked when quitting if all groups
1123                     read during the current session should  be  marked  read.
1124                     Default is OFF.
1125
1126              col_back
1127                     Standard background color
1128
1129              col_extquote
1130                     Color of quoted text from external sources
1131
1132              col_from
1133                     Color of sender (From:)
1134
1135              col_head
1136                     Color of header-lines
1137
1138              col_help
1139                     Color of help pages
1140
1141              col_invers_bg
1142                     Color of background for inverse text
1143
1144              col_invers_fg
1145                     Color of foreground for inverse text
1146
1147              col_markdash
1148                     Color   of   words   emphasized  like  _this_.  See  also
1149                     word_h_display_marks and word_highlight.
1150
1151              col_markslash
1152                     Color  of  words  emphasized  like   /this/.   See   also
1153                     word_h_display_marks and word_highlight.
1154
1155              col_markstar
1156                     Color   of   words   emphasized  like  *this*.  See  also
1157                     word_h_display_marks and word_highlight.
1158
1159              col_markstroke
1160                     Color  of  words  emphasized  like   -this-.   See   also
1161                     word_h_display_marks and word_highlight.
1162
1163              col_minihelp
1164                     Color of mini help menu
1165
1166              col_newsheaders
1167                     Color of actual news header fields
1168
1169              col_normal
1170                     Standard foreground color
1171
1172              col_quote
1173                     Color of quoted lines
1174
1175              col_quote2
1176                     Color of twice quoted lines
1177
1178              col_quote3
1179                     Color of >=3 times quoted lines
1180
1181              col_response
1182                     Color  of  response  counter.  This is the text that says
1183                     "Response x of y" in the article viewer.
1184
1185              col_signature
1186                     Color of signatures
1187
1188              col_urls
1189                     Color of urls highlight
1190
1191              col_verbatim
1192                     Color of verbatim blocks
1193
1194              col_subject
1195                     Color of article subject
1196
1197              col_text
1198                     Color of text-lines
1199
1200              col_title
1201                     Color of help/mail sign
1202
1203              confirm_choice
1204                     tin(1) can ask for manual  confirmation  to  protect  the
1205                     user. Available choices:
1206                          commands: Ask for confirmation before executing cer‐
1207                          tain dangerous commands (e.g., Catchup ('c')).  Com‐
1208                          mands  that  this  affects are marked in this manual
1209                          with '[after confirmation]'.
1210
1211                          quit: You'll be asked to confirm that  you  wish  to
1212                          exit tin(1) when you use the Quit ('q') command.
1213
1214                          select:  Ask for confirmation before marking all not
1215                          selected (with GroupMarkUnselArtRead ('X')  command)
1216                          articles as read.
1217                     Default is commands & quit.
1218
1219              date_format
1220                     Format string used for date representation. A description
1221                     of  the  different  format  options  can  be   found   at
1222                     strftime(3).   tin(1) uses strftime(3) when available and
1223                     supports  most  format  options  in  his  fallback  code.
1224                     Default is "%a, %d %b %Y %H:%M:%S".
1225
1226              default_art_search
1227
1228              default_author_search
1229
1230              default_config_search
1231                     The  last  article/author/config option that was searched
1232                     for.
1233
1234              default_filter_days
1235                     Default is 28.
1236
1237              default_filter_kill_case
1238                     Default for quick (1 key) kill filter case.  ON =  filter
1239                     case sensitive, OFF = ignore case. Default is OFF.
1240
1241              default_filter_kill_expire
1242                     Default for quick (1 key) kill filter expire.  ON = limit
1243                     to default_filter_days, OFF = don't ever expire.  Default
1244                     is OFF.
1245
1246              default_filter_kill_global
1247                     Default  for  quick (1 key) kill filter global.  ON=apply
1248                     to all groups, OFF=apply to current group. Default is ON.
1249
1250              default_filter_kill_header
1251                     Default for quick (1 key) kill filter header.
1252                        0     ''Subject:'' (case sensitive)
1253                        1     ''Subject:'' (ignore case)
1254                        2     ''From:'' (case sensitive)
1255                        3     ''From:'' (ignore case)
1256                        4     ''Message-ID:'' & full ''References:'' line
1257                        5     ''Message-ID:'' & last ''References:'' entry only
1258                        6     ''Message-ID:'' entry only
1259                        7     ''Lines:''
1260
1261              default_filter_select_case
1262                     Default for quick (1  key)  auto-selection  filter  case.
1263                     ON=filter  case  sensitive,  OFF=ignore  case. Default is
1264                     OFF.
1265
1266              default_filter_select_expire
1267                     Default for quick (1 key) auto-selection  filter  expire.
1268                     ON  =  limit  to  default_filter_days,  OFF  = don't ever
1269                     expire.  Default is OFF.
1270
1271              default_filter_select_global
1272                     Default for quick (1 key) auto-selection  filter  global.
1273                     ON=apply  to  all  groups,  OFF=apply  to  current group.
1274                     Default is ON.
1275
1276              default_filter_select_header
1277                     Default for quick (1 key) auto-selection filter header.
1278                        0     ''Subject:'' (case sensitive)
1279                        1     ''Subject:'' (ignore case)
1280                        2     ''From:'' (case sensitive)
1281                        3     ''From:'' (ignore case)
1282                        4     ''Message-ID:'' & full ''References:'' line
1283                        5     ''Message-ID:'' & last ''References:'' entry only
1284                        6     ''Message-ID:'' entry only
1285                        7     ''Lines:''
1286
1287              default_goto_group
1288
1289              default_group_search
1290
1291              default_mail_address
1292
1293              default_move_group
1294
1295              default_pattern
1296
1297              default_pipe_command
1298
1299              default_post_newsgroups
1300
1301              default_post_subject
1302
1303              default_range_group
1304
1305              default_range_select
1306
1307              default_range_thread
1308
1309              default_repost_group
1310
1311              default_save_file
1312
1313              default_save_mode
1314
1315              default_select_pattern
1316
1317              default_shell_command
1318
1319              default_subject_search
1320
1321              draw_arrow
1322                     Allows groups/articles to be selected by an arrow '->' if
1323                     set  ON  or  by  a highlighted bar if set OFF. Default is
1324                     OFF.
1325
1326              editor_format
1327                     The format string used to create the editor start command
1328                     with  parameters.  Default is '%E +%N %F' with %E=Editor,
1329                     %N=Linenumber and %F=Filename (e.g.,  /bin/vi  +7  .arti‐
1330                     cle).
1331
1332              extquote_handling
1333                     If  ON  quotes  from  external  sources will be detected.
1334                     Default is OFF.
1335
1336              extquote_regex
1337                     A regular expression that will be  applied  when  reading
1338                     articles.  All  matching lines are shown in col_extquote.
1339                     If extquote_regex is blank, then tin(1) uses  a  built-in
1340                     default.
1341
1342              force_screen_redraw
1343                     Specifies  whether  a screen redraw should always be done
1344                     after certain external commands. Default is OFF.
1345
1346              getart_limit
1347                     If  getart_limit  is  >  0  not  more   than   the   last
1348                     getart_limit  articles/group are fetched from the server.
1349                     If getart_limit is < 0 tin(1) will start  fetching  arti‐
1350                     cles  from  your  first  unread  minus  absolute value of
1351                     getart_limit. Default is 0, which means no limit.
1352
1353              goto_next_unread
1354                     Which keys tin(1) should  accept  to  jump  to  the  next
1355                     unread  article.  Possible is any combination of PageDown
1356                     and PageNextUnread.  When PageDown is set tin(1) jumps to
1357                     the  next  article  at  the  end of the current one. When
1358                     PageNextUnread is set tin(1)  jumps  immediately  to  the
1359                     next  article  when  PageNextUnread ('<TAB>') is pressed.
1360                     Default is PageNextUnread.
1361
1362              group_catchup_on_exit
1363                     If ON catchup group when leaving with the left arrow key.
1364                     Default is ON.
1365
1366              group_format
1367                     The  format  string  used for the Group level. Default is
1368                     "%n %m %R %L  %s  %F". The  following  substitutions  are
1369                     supported:
1370                        %D    date
1371                        %F    from, name and/or address
1372                        %I    initials
1373                        %L    line count
1374                        %M    message-id
1375                        %R    number of responses in thread
1376                        %S    score
1377                        %m    article marks
1378                        %n    current thread number
1379                        %s    subject
1380                        %%    %
1381
1382              hide_uue
1383                     If  set  to 'No' then raw uuencoded data is displayed. If
1384                     set to 'Yes' then sections  of  uuencoded  data  will  be
1385                     shown  with  a single tag line showing the size and file‐
1386                     name (much the same as a MIME  attachment).   If  set  to
1387                     'Hide  all'  then any line that looks like uuencoded data
1388                     will be folded into a tag line. This is useful when uuen‐
1389                     coded  data is split across more than one article but can
1390                     also lead to false positives. This setting  can  also  be
1391                     toggled in the article viewer.  Default is 'No'.
1392
1393              inews_prog
1394                     Path,  name and options of external inews(1).  If you are
1395                     reading via NNTP the default value is  "--internal"  (use
1396                     built-in  NNTP inews), else it is "inews -h". The article
1397                     is passed to inews_prog on STDIN via '< article'.
1398
1399              info_in_last_line
1400                     If ON, show current group description or article  subject
1401                     in  the  last  line  (not in the pager and global menu) —
1402                     ToggleInfoLastLine ('i') toggles setting.  This  facility
1403                     is useful as the full width of the screen is available to
1404                     display long subjects. Default is OFF.
1405
1406              interactive_mailer
1407                     If greater than 0 your mailreader will be invoked earlier
1408                     for reply so you can use more of its features (e.g. MIME,
1409                     pgp, ...). 1 means include headers, 2 means don't include
1410                     headers  (old  use_mailreader_i=ON  option).  0 turns off
1411                     usage. This option has to suit mailer_format. Default  is
1412                     0.
1413
1414              inverse_okay
1415                     If  ON  use  inverse video for page headers and URL high‐
1416                     lighting.  Default is ON.
1417
1418              keep_dead_articles
1419                     If  ON  keep   all   failed   postings   in   ${TIN_HOME‐
1420                     DIR:-"$HOME"}/dead.articles   besides  keeping  the  last
1421                     failed posting  in  ${TIN_HOMEDIR:-"$HOME"}/dead.article.
1422                     Default is ON.
1423
1424              kill_level
1425                     This  option controls the processing and display of arti‐
1426                     cles that are killed. There are 3 options, default  is  0
1427                     (Kill only unread arts).
1428
1429                        0  Kill only unread arts is the 'traditional' behavior
1430                           of tin(1).  Only unread articles  are  killed  once
1431                           only  by  marking them read. As filtering only hap‐
1432                           pens on unread articles with kill_level set  to  0,
1433                           art_marked_killed  and art_marked_read_selected are
1434                           only shown once. When you  reenter  the  group  the
1435                           mark will be gone.
1436
1437                        1  Kill  all arts & show with K will process all arti‐
1438                           cles in the group and therefore there is a process‐
1439                           ing  overhead  when using this option. Killed arti‐
1440                           cles are threaded as normal but they will be marked
1441                           with art_marked_killed.
1442
1443                        2  Kill all arts and never show will process all arti‐
1444                           cles in the group and therefore there is a process‐
1445                           ing  overhead  when using this option. Killed arti‐
1446                           cles simply does not get displayed at all.
1447
1448              mail_8bit_header
1449                     Allows 8bit characters unencoded in the  header  of  mail
1450                     message.  Default is OFF. Turning it ON is effective only
1451                     if mail_mime_encoding is also set to 8bit. Leaving it OFF
1452                     is  safe  for  most  users and compliant to Internet Mail
1453                     Standard (RFC5322 and RFC2047). Default is OFF.
1454
1455              mail_address
1456                     User's  mail  address  (and  full  name),  if  not  user‐
1457                     name@host.  This  is used when creating articles, sending
1458                     mail and when pgp(1) signing.
1459
1460              mail_mime_encoding
1461                     MIME encoding of the body in mail message,  if  necessary
1462                     (8bit,   base64,   quoted-printable,  7bit).  Default  is
1463                     quoted-printable.
1464
1465              mail_quote_format
1466                     Format of quote line when replying (via mail) to an arti‐
1467                     cle  (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1468                     name, %M=Message-ID, %N=Fullname,  %C=Firstname,  %I=Ini‐
1469                     tials). Default is "In article %M you wrote:"
1470
1471              mailbox_format
1472                     Select   one  of  the  following  mailbox-formats:  MBOXO
1473                     (default, except on SCO),  MBOXRD  or  MMDF  (default  on
1474                     SCO).  See  mbox(5) and RFC4155 for more details on MBOXO
1475                     and MBOXRD and mmdf(5) for more details about MMDF.
1476
1477              maildir
1478                     The directory where articles/threads are to be  saved  in
1479                     mbox(5)  format.  This feature is mainly for use with the
1480                     elm(1) mail program. It allows the  user  to  save  arti‐
1481                     cles/threads/groups  simply by giving '=' as the filename
1482                     to save to.  Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.
1483
1484              mailer_format
1485                     The format string used to create the mailer command  with
1486                     parameters  that  is  used  for mailing articles to other
1487                     people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1488                     <  .article).  The  flexible  format allows other mailers
1489                     with different command line parameters to be used such as
1490                        sendmail -oem -t < %F
1491                        elm -s "%S" "%T" < "%F"
1492                        claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1493                     interactive_mailer must be set  adequate.  The  following
1494                     substitutions are supported:
1495                        %F              filename
1496                        %M              default_mailer
1497                        %S              subject-field
1498                        %T              to-filed
1499                        %U              username
1500                        %%              %
1501
1502              mark_saved_read
1503                     If  ON  mark  articles that are saved as read. Default is
1504                     ON.
1505
1506              mark_ignore_tags
1507                     When this is  ON,  the  GroupMarkThdRead  ('K'),  Thread‐
1508                     MarkArtRead ('K'), MarkThdUnread ('Z') at Group level and
1509                     MarkArtUnread ('z') at Thread level functions  mark  just
1510                     the  current  article  or  thread, ignoring other tagged,
1511                     (un)read articles. When OFF, the same function presents a
1512                     menu  with  choices of the current thread or article, all
1513                     tagged, unread articles, or nothing.
1514
1515              metamail_prog
1516                     Path, name and options of  external  metamail(1)  program
1517                     used  to  view non-textual parts of articles.  To use the
1518                     built-in viewer, set to --internal. This is  the  default
1519                     value  when  metamail(1) is not installed. Leave it blank
1520                     if you don't want any automatic  viewing  of  non-textual
1521                     attachments.  The 'V' command can always be used to manu‐
1522                     ally view any attachments. See also ask_for_metamail.
1523
1524              mm_charset
1525                     Charset supported locally, which is also  used  for  MIME
1526                     header  (charset  parameter  and  charset  name in header
1527                     encoding)    in    mail    and    news    postings.    If
1528                     MIME_STRICT_CHARSET  is  defined at compile time, text in
1529                     charset other than the value of this parameter is consid‐
1530                     ered  not  displayable and represented as '?'. Otherwise,
1531                     all character sets are regarded as  compatible  with  the
1532                     display.  If  it's  not set, the value of the environment
1533                     variable $MM_CHARSET is used.  US-ASCII  or  compile-time
1534                     default  is  used  in case neither of them is defined. If
1535                     your system supports iconv(3), this  option  is  disabled
1536                     and you should use mm_network_charset instead.
1537
1538              mm_network_charset
1539                     Charset  used  for  posting  and  MIME  headers; replaces
1540                     mm_charset.  Conversion  between  mm_network_charset  and
1541                     local charset (determined via nl_langinfo(3)) is done via
1542                     iconv(3), if this function is not available on your  sys‐
1543                     tem   this  option  is  disabled  and  you  have  to  use
1544                     mm_charset instead. mm_network_charset is limited to  one
1545                     of the following charsets:
1546                        US-ASCII,     ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1547                        KOI8-{R,U,RU}   EUC-{CN,JP,KR,TW},    ISO-2022-{CN,CN-
1548                        EXT,JP,JP-1,JP-2}, Big5, UTF-8
1549                     Not   all   values   might   work  on  your  system,  see
1550                     iconv_open(3) for more details.  If  it's  not  set,  the
1551                     value  of  the  environment variable $MM_CHARSET is used.
1552                     US-ASCII or compile-time default is used in case  neither
1553                     of them is defined.
1554
1555              mono_markdash
1556                     Character  attribute  of words emphasized like _this_. It
1557                     depends on your terminal which attributes are usable. See
1558                     also word_h_display_marks and word_highlight.
1559
1560              mono_markslash
1561                     Character  attribute  of words emphasized like /this/. It
1562                     depends on your terminal which attributes are usable. See
1563                     also word_h_display_marks and word_highlight.
1564
1565              mono_markstar
1566                     Character  attribute  of words emphasized like *this*. It
1567                     depends on your terminal which attributes are usable. See
1568                     also word_h_display_marks and word_highlight.
1569
1570              mono_markstroke
1571                     Character  attribute  of words emphasized like -this-. It
1572                     depends on your terminal which attributes are usable. See
1573                     also word_h_display_marks and word_highlight.
1574
1575              newnews
1576                     These are internal timers used by tin(1) to keep track of
1577                     new newsgroups. Do not change them unless you  understand
1578                     what they are for.
1579
1580              news_headers_to_display
1581                     Which  news  headers  you wish to see. If you want to see
1582                     _all_ the headers, place an '*' as this  value.  This  is
1583                     the  only  way a wildcard can be used.  If you enter 'X-'
1584                     as the value, you will see  all  headers  beginning  with
1585                     'X-'  (like X-Alan or X-Pape). You can list more than one
1586                     by delimiting with spaces. Not  defining  anything  turns
1587                     off this option.
1588
1589              news_headers_to_not_display
1590                     Same  as  news_headers_to_display  except  it denotes the
1591                     opposite. An example of using both options  might  be  if
1592                     you  thought  'X-'  headers  were  A  Good Thing(tm), but
1593                     thought Alan and Pape were miscreants...  well  then  you
1594                     would  do something like this: news_headers_to_display=X-
1595                     news_headers_to_not_display=X-Alan  X-Pape  Not  defining
1596                     anything turns off this option.
1597
1598              news_quote_format
1599                     Format of quote line when posting/following up an article
1600                     (%A=Address, %D=Date, %F=Fullname+Address,  %G=Groupname,
1601                     %M=Message-ID,  %N=Fullname,  %C=Firstname, %I=Initials).
1602                     Default is "%F wrote:".
1603
1604              nntp_read_timeout_secs
1605                     Time in seconds to wait for a response from  the  server.
1606                     Default is 120.
1607
1608              normalization_form
1609                     The  normalization form which should be used to normalize
1610                     unicode input.  The possible values are:
1611
1612                        0  None: no normalization
1613
1614                        1  NFKC:  Compatibility  Decomposition,  followed   by
1615                           Canonical Composition
1616
1617                        2  NFKD: Compatibility Decomposition
1618
1619                        3  NFC: Canonical Decomposition, followed by Canonical
1620                           Composition
1621
1622                        4  NFD: Canonical Decomposition
1623
1624                        5  NFKC_CF: Compatibility Decomposition,  followed  by
1625                           Canonical Composition and Case Folding
1626              Some  normalization  modes  are  only available if they are sup‐
1627              ported by the library tin(1) uses to do the  normalization.  NFC
1628              should be used if possible.
1629
1630              pos_first_unread
1631                     If  ON put cursor at first unread article in group other‐
1632                     wise at last article. Default is ON.
1633
1634              post_8bit_header
1635                     Allows 8bit characters unencoded in the header of a  news
1636                     article,  if  set  this  also  disables the generation of
1637                     MIME-headers when they are usually required.  Default  is
1638                     OFF.  Only  enacted  if post_mime_encoding is also set to
1639                     8bit. In a number of local hierarchies where 8bit charac‐
1640                     ters  are  used, using unencoded (raw) 8bit characters in
1641                     header is acceptable and sometimes  even  recommended  so
1642                     that  you  need  to  check  the convention adopted in the
1643                     local hierarchy of your interest to determine what to  do
1644                     with this and post_mime_encoding.
1645
1646              post_mime_encoding
1647                     MIME  encoding of the body in news message, if necessary.
1648                     (8bit, base64, quoted-printable, 7bit). Default is  8bit,
1649                     which  leads to no encoding.  base64 and quoted-printable
1650                     are usually undesired on usenet.
1651
1652              post_process_view
1653                     If ON, then tin(1) will start an appropriate viewer  pro‐
1654                     gram  to  display  any files that were post processed and
1655                     uudecoded. The program is determined using the mailcap(5)
1656                     file. Default is ON.
1657
1658              post_process_type
1659                     This  specifies  whether  to  perform  post processing on
1660                     saved articles.  Because the shell  archive  may  contain
1661                     commands you may not want to be executed, be careful when
1662                     extracting shell  archives.   The  following  values  are
1663                     allowed:
1664
1665                        0  No (default), no post processing is done.
1666
1667                        1  Shell  archives,  unpacking  of  multi-part shar(1)
1668                           files only. Because the shell archive  may  contain
1669                           commands  you may not want to be executed, be care‐
1670                           ful with this option.
1671
1672                        2  Yes, binary attachments and data  will  be  decoded
1673                           and saved.
1674
1675              posted_articles_file
1676                     Keep       posted       articles      in      ${TIN_HOME‐
1677                     DIR:-"$HOME"}/Mail/posted_articles_file.  If no  filename
1678                     is  set  then  postings  will  not  be saved.  Default is
1679                     'posted'.
1680
1681              print_header
1682                     If ON, then the  full  article  header  is  sent  to  the
1683                     printer.  Otherwise  only  the ''Subject:'' and ''From:''
1684                     fields are output. Default is OFF.
1685
1686              printer
1687                     The printer program with options that is to  be  used  to
1688                     print  articles.  The  default is lpr(1) for BSD machines
1689                     and lp(1) for SysV machines.  Printing  from  tin(1)  may
1690                     have been disabled by the System Administrator.
1691
1692              process_only_unread
1693                     If  ON  only save/print/pipe/mail unread articles (tagged
1694                     articles excepted).  Default is OFF.
1695
1696              prompt_followupto
1697                     If ON show empty ''Followup-To:'' header when editing  an
1698                     article.  Default is OFF.
1699
1700              quote_chars
1701                     The  character  used  in quoting included text to article
1702                     followups and mail replies. The '_' character  represents
1703                     a  blank character and is replaced with ' ' when read, %I
1704                     is replaced by author's initials. Default is '>_'.
1705
1706              quote_style
1707                     This bit coded integer value controls how articles are to
1708                     be  quoted  when following up or replying to them. Any of
1709                     the following options can be combined by adding all rele‐
1710                     vant values. Default is 5, which means that quote charac‐
1711                     ters are compressed and empty lines are quoted.
1712
1713                        1  Compress quotes Compress quote characters  together
1714                           when  quoting  multiple times (for example, '> > >'
1715                           will be turned into '>>>'). This option  is  on  by
1716                           default.
1717
1718                        2  Quote  Signatures  This  option  is off by default.
1719                           Signatures are always  quoted  regardless  of  this
1720                           option  when you are viewing an article in raw mode
1721                           PageToggleRaw ('^H') and followup or reply  to  it.
1722                           Signatures  are  never  quoted  regardless  of this
1723                           option when show_signatures is off.
1724
1725                        4  Quote empty lines This option is on by default.
1726
1727              quote_regex
1728                     A regular expression that will be  applied  when  reading
1729                     articles.  All  matching lines are shown in col_quote. If
1730                     quote_regex  is  blank,  then  tin(1)  uses  a   built-in
1731                     default.
1732
1733              quote_regex2
1734                     A  regular  expression  that will be applied when reading
1735                     articles. All matching lines are shown in col_quote2.  If
1736                     quote_regex2  is  blank,  then  tin(1)  uses  a  built-in
1737                     default.
1738
1739              quote_regex3
1740                     A regular expression that will be  applied  when  reading
1741                     articles.  All matching lines are shown in col_quote3. If
1742                     quote_regex3  is  blank,  then  tin(1)  uses  a  built-in
1743                     default.
1744
1745              recent_time
1746                     If  set  to  0, this feature is deactivated, otherwise it
1747                     means the number of days. Default is 2.
1748
1749              render_bidi
1750                     If ON tin(1) does the rendering of  bi-directional  text.
1751                     If OFF tin(1) leaves the rendering of bi-directional text
1752                     to the terminal. Default is OFF.
1753
1754              reread_active_file_secs
1755                     The    news     ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1756                     FILE:-active} file is reread at regular intervals to show
1757                     if any new news has arrived.  Default  is  1200.  Setting
1758                     this to 0 will disable this feature.
1759
1760              savedir
1761                     Directory  where  articles/threads  are saved. Default is
1762                     ${TIN_HOMEDIR:-"$HOME"}/News.
1763
1764              score_limit_kill
1765                     If the score of an article is below or equal  this  value
1766                     the article gets marked as killed.
1767
1768              score_limit_select
1769                     If  the  score of an article is above or equal this value
1770                     the article gets marked as hot.
1771
1772              score_kill
1773                     Score of an article which should be killed, this must  be
1774                     <= score_limit_kill.
1775
1776              score_select
1777                     Score of an article which should be marked hot, this must
1778                     be >= score_limit_select.
1779
1780              scroll_lines
1781                     The number of lines that will be scrolled up/down in  the
1782                     article pager when using cursor-up/down. The default is 1
1783                     (line-by-line). Set to 0 to get traditional tin  page-by-
1784                     page  scrolling.  Set to -1 to get page-by-page scrolling
1785                     where the top/bottom line is carried over onto  the  next
1786                     page.           This          setting          supersedes
1787                     show_last_line_prev_page=ON. Set to -2 to  get  half-page
1788                     scrolling. This setting supersedes full_page_scroll=OFF.
1789
1790              select_format
1791                     The  format  string used for the Selection level. Default
1792                     is "%f %n %U  %G  %d". The  following  substitutions  are
1793                     supported:
1794                        %G    group name
1795                        %U    unread count
1796                        %d    description
1797                        %f    group flag
1798                        %n    current group number
1799                        %%    %
1800
1801              sort_function
1802                     Function used for sorting articles. Default is 0.
1803
1804                   0  Use qsort(3) for sorting.
1805
1806                   1  Use  heapsort(3)  for  sorting.  This might be faster in
1807                      large  groups  with  long  threads  (somewhat  presorted
1808                      data).
1809
1810              show_author
1811                     Which  information  about  the  author  should  be shown.
1812                     Default is 2, authors full name.
1813
1814                        0  None, only the ''Subject:'' line will be displayed.
1815
1816                        1  Address, ''Subject:'' line & the  address  part  of
1817                           the ''From:'' line are displayed.
1818
1819                        2  Full  Name,  ''Subject:''  line  & the authors full
1820                           name part  of  the  ''From:''  line  are  displayed
1821                           (default).
1822
1823                        3  Address  and  Name,  ''Subject:'' line & all of the
1824                           ''From:'' line are displayed.
1825
1826              show_description
1827                     If ON show a short group description text after newsgroup
1828                     name  at  the  group selection level. The ''-d'' command-
1829                     line flag will override the setting and turn descriptions
1830                     off.   The   text  used  is  taken  from  the  ${TIN_LIB‐
1831                     DIR:-NEWSLIBDIR}/newsgroups   file   and   if   supported
1832                     (requires  tin(1)  to be build with mh-mail-handling sup‐
1833                     port)  from  ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups  for
1834                     mailgroups. Default is ON.
1835
1836              show_info
1837                     Which  information  about the thread or article should be
1838                     shown. Default is 1, show only the line count.
1839
1840                        0  None, no information will be displayed.
1841
1842                        1  Lines, in article listing  the  line  count  of  an
1843                           article will be displayed and in thread listing the
1844                           line count of first (unread) article will  be  dis‐
1845                           played.
1846
1847                        2  Score,  in  article listing the score of an article
1848                           will be displayed and in thread listing  the  score
1849                           of   the  thread  will  be  displayed  —  see  also
1850                           thread_score.
1851
1852                        3  Lines & Score, display line count and score.
1853
1854              show_only_unread_arts
1855                     If ON show only new/unread articles  otherwise  show  all
1856                     articles.  Default is ON.
1857
1858              show_only_unread_groups
1859                     If  ON  show  only  subscribed groups that contain unread
1860                     articles. Default is OFF.
1861
1862              show_signatures
1863                     If OFF don't show signatures  when  displaying  articles.
1864                     Default is ON.
1865
1866              sigdashes
1867                     If  ON  prepend  the signature with sigdashes. Default is
1868                     ON.
1869
1870              sigfile
1871                     The path that specifies the signature file  to  use  when
1872                     posting,  following  up  to or replying to an article. If
1873                     the path is a directory then the signature will  be  ran‐
1874                     domly  generated  from  files  that  are in the specified
1875                     directory. If the path starts with a !  the  program  the
1876                     path  points to will be executed to generate a signature.
1877                     In order to pass the group name to the program, %G can be
1878                     specified.  This will be replaced by the name of the cur‐
1879                     rent  newsgroup.  --none  will  suppress  any  signature.
1880                     Default is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
1881
1882              signature_repost
1883                     If ON add signature to reposted articles. Default is ON.
1884
1885              slashes_regex
1886                     A  regular  expression  that will be applied when reading
1887                     articles. All matching words are shown  in  col_markslash
1888                     or mono_markslash. If slashes_regex is blank, then tin(1)
1889                     uses a built-in default.
1890
1891              sort_article_type
1892                     This specifies how articles should  be  sorted.  Sort  by
1893                     ascending  Date  (6)  is  the default. The following sort
1894                     types are allowed:
1895
1896                        0  Nothing, don't sort articles.
1897
1898                        1  Subject:  (descending),  sort  articles  by  ''Sub‐
1899                           ject:'' field descending.
1900
1901                        2  Subject: (ascending), sort articles by ''Subject:''
1902                           field ascending.
1903
1904                        3  From:  (descending),  sort  articles  by  ''From:''
1905                           field descending.
1906
1907                        4  From: (ascending), sort articles by ''From:'' field
1908                           ascending.
1909
1910                        5  Date:  (descending),  sort  articles  by  ''Date:''
1911                           field descending.
1912
1913                        6  Date: (ascending), sort articles by ''Date:'' field
1914                           ascending (default).
1915
1916                        7  Score  (descending),  sort  articles  by  filtering
1917                           score descending.
1918
1919                        8  Score (ascending), sort articles by filtering score
1920                           ascending.
1921
1922                        9  Lines: (descending), sort  articles  by  ''Lines:''
1923                           field descending.
1924
1925                        10 Lines:  (ascending),  sort  articles  by ''Lines:''
1926                           field ascending.
1927
1928              sort_threads_type
1929                     This specifies  how  threads  will  be  sorted.  Sort  by
1930                     descending  Score  (1) is the default. The following sort
1931                     types are allowed:
1932
1933                        0  Nothing, don't sort threads.
1934
1935                        1  Score (descending), sort threads by filtering score
1936                           descending (default).
1937
1938                        2  Score  (ascending), sort threads by filtering score
1939                           ascending.
1940
1941                        3  Last posting date  (descending),  sort  threads  by
1942                           date of last posting descending.
1943
1944                        4  Last posting date (ascending), sort threads by date
1945                           of last posting ascending.
1946
1947              spamtrap_warning_addresses
1948                     Set this option to a list of comma-separated  strings  to
1949                     be warned if you are replying to an article by mail where
1950                     the e-mail address contains one  of  these  strings.  The
1951                     matching is case-insensitive. Example:
1952
1953                     spam,delete,remove
1954
1955              stars_regex
1956                     A  regular  expression  that will be applied when reading
1957                     articles. All matching words are shown in col_markstar or
1958                     mono_markstar.  If stars_regex is blank, then tin(1) uses
1959                     a built-in default.
1960
1961              start_editor_offset
1962                     Set ON if the editor used for posting, follow-ups and bug
1963                     reports  has  the  capability of starting and positioning
1964                     the cursor at a specified line within a file. Default  is
1965                     ON.
1966
1967              strip_blanks
1968                     Strips  the  blanks  from  the end of each line therefore
1969                     speeding up the display when reading on a  slow  terminal
1970                     or via modem. Default is ON.
1971
1972              strip_bogus
1973                     Bogus   groups  are  groups  that  are  present  in  your
1974                     ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
1975                     on the news server. There are 3 options. 0 means do noth‐
1976                     ing & always keep bogus groups.   1  means  bogus  groups
1977                     will  be  permanently  removed. 2 means that bogus groups
1978                     will appear on the Group Selection Menu, prefixed with  a
1979                     'D'. This allows you to unsubscribe from them as and when
1980                     you wish. Default is 0 (Always Keep).
1981
1982              strip_newsrc
1983                     If ON,  then  unsubscribed  groups  will  be  permanently
1984                     removed  from  your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file.
1985                     Default is OFF.
1986
1987              strokes_regex
1988                     A regular expression that will be  applied  when  reading
1989                     articles.  All matching words are shown in col_markstroke
1990                     or mono_markstroke.   If  strokes_regex  is  blank,  then
1991                     tin(1) uses a built-in default.
1992
1993              tex2iso_conv
1994                     Decode  German  style TeX umlaut codes to ISO If ON, show
1995                     "a as Umlaut-a, etc. Default is OFF.  This  behavior  can
1996                     also  be  toggled  in  the article viewer via PageToggle‐
1997                     Tex2iso ('"').
1998
1999              thread_articles
2000                     Defines which threading method to use. The  choices  are:
2001                     0)  Don't  thread, 1) Thread on Subject only 2) Thread on
2002                     References only, 3) Thread  on  References  then  Subject
2003                     (default)  4)  Thread  multipart articles on Subject.  5)
2004                     Thread on Percentage Match of the Subjects It's also pos‐
2005                     sible  to  set the threading type on a per group basis by
2006                     setting the group attribute variable thread_articles to 0
2007                     – 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.
2008
2009              thread_format
2010                     The  format  string used for the Thread level. Default is
2011                     "%n %m  [%L]  %T  %F". The  following  substitutions  are
2012                     supported:
2013                        %D    date
2014                        %F    from, name and/or address
2015                        %I    initials
2016                        %L    line count
2017                        %M    message-id
2018                        %S    score
2019                        %T    thread tree
2020                        %m    article marks
2021                        %n    current article number
2022                        %%    %
2023
2024              thread_perc
2025                     Defines how close the subjects must match while threading
2026                     by Percentage Match for threads to be considered part  of
2027                     a single thread. This value is in the range 0 to 100. The
2028                     default is 75.
2029
2030              thread_catchup_on_exit
2031                     If ON catchup group/thread when  leaving  with  the  left
2032                     arrow key. Default is ON.
2033
2034              thread_score
2035                     How  the  total score of a thread is computed. Default is
2036                     0, the maximum score in this thread.
2037
2038                        0  Max, the maximum score in this thread.
2039
2040                        1  Sum, the sum of all scores in this thread.
2041
2042                        2  Average, the average score in this thread.
2043
2044              translit
2045                     If  ON  append  //TRANSLIT  to  the  first  argument   of
2046                     iconv_open(3)  to enable transliteration. This means that
2047                     when a character cannot  be  represented  in  the  target
2048                     character set, it can be approximated through one or sev‐
2049                     eral similarly looking characters. On systems where  this
2050                     extension doesn't exist, this option is disabled. Default
2051                     is OFF.
2052
2053              trim_article_body
2054                     Allows you to select how tin(1)  treats  blank  lines  in
2055                     article  bodies.   Default  is  0.  This  option does not
2056                     affect lines within verbatim blocks.
2057
2058                        0  Don't trim article body, do nothing.
2059
2060                        1  Skip leading blank lines.
2061
2062                        2  Skip trailing blank lines.
2063
2064                        3  Skip leading and trailing blank  l.,  skip  leading
2065                           and trailing blank lines.
2066
2067                        4  Compact  multiple  between  text,  replace multiple
2068                           blank lines between textblocks with one blank line.
2069
2070                        5  Compact multiple and skip leading, 4 + 1
2071
2072                        6  Compact multiple and skip trailing, 4 + 2
2073
2074                        7  Compact mltpl., skip lead. & trai., 4 + 3
2075
2076              underscores_regex
2077                     A regular expression that will be  applied  when  reading
2078                     articles. All matching words are shown in col_markdash or
2079                     mono_markdash. If underscores_regex is blank, then tin(1)
2080                     uses a built-in default.
2081
2082              unlink_article
2083                     If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post‐
2084                     ing. Default is ON.
2085
2086              url_handler
2087                     The program that will be run when launching URLs  in  the
2088                     article  viewer  using  PageViewUrl ('U'). The actual URL
2089                     will be appended.  Default is url_handler.pl.
2090
2091              url_highlight
2092                     Enable highlighting URLs in message body. Default is ON.
2093
2094              use_color
2095                     If enabled tin(1) uses ANSI-colors. Default is OFF.
2096
2097              use_keypad
2098                     Use scroll keys on keypad. Default is OFF.
2099
2100              use_mouse
2101                     Allows the mouse button support in  an  xterm(1x)  to  be
2102                     enabled/disabled.  Default is OFF.
2103
2104              use_slrnface
2105                     If  enabled  slrnface(1)  will  be  used to interpret the
2106                     ''X-Face:'' header. For this option to have  any  effect,
2107                     tin(1)  must  be  running in an xterm(1x) and slrnface(1)
2108                     must be in your $PATH. Default is OFF.
2109
2110              utf8_graphics
2111                     If  ON  use  UTF-8  characters  for   indicator   ('->'),
2112                     thread/attachment  tree  and ellipsis ('...'). Default is
2113                     OFF.
2114
2115              verbatim_begin_regex
2116                     A regular expression that tin will use to find the  begin
2117                     of a verbatim block.  Default is #v+
2118
2119              verbatim_end_regex
2120                     A regular expression that tin will use to find the end of
2121                     a verbatim block.  Default is #v-
2122
2123              verbatim_handling
2124                     If ON verbatim blocks will be detected. Default is ON.
2125
2126              wildcard
2127                     Allows you to select  how  tin(1)  matches  strings.  The
2128                     default  is 0 and uses the wildmat notation, which is how
2129                     this has traditionally been handled.  Setting this  to  1
2130                     allows  you to use perl(1) compatible regular expressions
2131                     pcre(3).  (see also perlre(1) and  pcrepattern(3)).   You
2132                     will  probably want to update your filter file if you use
2133                     this regularly.   NB:  Newsgroup  names  will  always  be
2134                     matched using the wildmat notation.
2135
2136              word_h_display_marks
2137                     Should the leading and ending stars, slashes, strokes and
2138                     dashes also be displayed, even when they are highlighting
2139                     marks?
2140
2141                        0  no
2142
2143                        1  yes, display mark
2144
2145                        2  print a space instead
2146
2147              word_highlight
2148                     Enable  word  highlighting.  See word_h_display_marks for
2149                     the options available. If use_color is enabled the colors
2150                     specified  in  col_markdash,  col_markslash, col_markstar
2151                     and col_markstroke are used for  word  highlighting  else
2152                     the  character  attributes  specified  in  mono_markdash,
2153                     mono_markslash,  mono_markstar  and  mono_markstroke  are
2154                     used. Default is ON.
2155
2156              wrap_column
2157                     Sets  the column at which a displayed article body should
2158                     be wrapped.  If this value is equal to 0, it defaults  to
2159                     the  current screen width.  If this value is greater than
2160                     your current screen width the part off-screen is not dis‐
2161                     played.  Thus setting this option to a large value can be
2162                     used to disable wrapping. If this value is  negative  the
2163                     wrap  margin  is  the current screen width plus the given
2164                     value (as long as the result is still positive, otherwise
2165                     it  will  fall back to the current screen width). Default
2166                     is 0, wrapping at the current screen width.
2167
2168              wrap_on_next_unread
2169                     If enabled a search for the next unread article will wrap
2170                     around  all  articles  to find also previous unread arti‐
2171                     cles. If disabled the search stops  at  the  end  of  the
2172                     thread list. Default is ON.
2173
2174              xpost_quote_format
2175                     Format is the same as for news_quote_format, this is used
2176                     when answering to a crossposting to several  groups  with
2177                     no ''Followup-To:'' set.
2178
2179       /etc/tin/tin.defaults
2180
2181              Yet  another  global  configuration  file  with "variable=value"
2182              pairs. This one is for the more general  options  which  usually
2183              can't  be  controlled via ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc and/or
2184              ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc like resetting  (to  override
2185              the built-in default) the newslibdir.
2186
2187              domainname
2188                     Sets a global domain name used in From lines
2189
2190              organization
2191                     Defines  the  name  of  your  organization. $ORGANIZATION
2192                     overrides any specified value.
2193
2194              newslibdir
2195                     Defines the default place for some  configuration  files,
2196                     common    values    are   /usr/lib/news,   /var/lib/news,
2197                     /usr/local/lib/news or  /news/db.  $TIN_LIBDIR  overrides
2198                     any specified value.
2199
2200              bugaddress
2201                     Defines  the  email  address  to which users can send bug
2202                     reports using a built-in function. The default points  to
2203                     a  developers  mailing list located at tin.org. You might
2204                     want to change this address to one of your local adminis‐
2205                     tration  if you want to deal with your lusers problems on
2206                     your own.
2207
2208              inewsdir
2209                     Defines the directory containing the inews(1) executable.
2210
2211              mm_charset
2212                     Default charset to be used  in  MIME's  ''Content-Type:''
2213                     header. $MM_CHARSET overrides any specified value.
2214
2215              post_mime_encoding
2216                     Default encoding scheme used in MIME articles. 8bit might
2217                     be the best value.
2218
2219              mail_mime_encoding
2220                     Default   encoding   scheme   used   in   MIME   letters.
2221                     quoted-printable is a good choice here.
2222
2223              disable_gnksa_domain_check
2224                     Allow  unregistered  top  level  domains.  As the list of
2225                     valid TLDs is no longer actively maintained  the  default
2226                     was changed to ON starting with tin(1) version 2.1.5
2227
2228              disable_sender
2229                     Don't  generate  a ''Sender:'' header. This has an effect
2230                     only if inews_prog is set to --internal.
2231
2232              spooldir
2233                     Base of your newsspool (Bnews, Cnews and INN  traditional
2234                     spool   style),   common   values   are  /var/spool/news,
2235                     /usr/spool/news,  /news/spool.   $TIN_SPOOLDIR  overrides
2236                     any specified value.
2237
2238              overviewdir
2239                     Base  of  your  NOV  database  newsoverview(5) (tradspool
2240                     style; might be the same dir as spooldir), common  values
2241                     are /var/spool/overview, /usr/spool/overview, /news/over‐
2242                     view. $TIN_NOVROOTDIR overrides any specified value.
2243
2244              overviewfile
2245                     Name of a single overview file, common values are  .over‐
2246                     view, over.view. $TIN_NOVFILENAME overrides any specified
2247                     value.
2248
2249              overviewfmtfile
2250                     Full pathname of  your  newssystem's  overview.fmt  file;
2251                     usually  the  overview.fmt  file is in newslibdir, so you
2252                     only have to change this setting  if  your  configuration
2253                     differs.
2254
2255              activefile
2256                     Full  pathname  of your newssystem's active file; usually
2257                     the active  file  resides  in  newslibdir  and  is  named
2258                     active,  so  you only have to change this setting if your
2259                     configuration  differs.  $TIN_ACTIVEFILE  overrides   any
2260                     specified value.
2261
2262              activetimesfile
2263                     Full  pathname  of  your  newssystem's active.times file;
2264                     usually the active.times file is newslibdir, so you  only
2265                     have  to  change  this setting if your configuration dif‐
2266                     fers.
2267
2268              newsgroupsfile
2269                     Full pathname of your newssystem's newsgroups file;  usu‐
2270                     ally  the  newsgroups  file is in newslibdir, so you only
2271                     have to change this setting if  your  configuration  dif‐
2272                     fers.
2273
2274              subscriptionsfile
2275                     Full  pathname  of  your newssystem's subscriptions file;
2276                     usually the subscriptions file is in newslibdir,  so  you
2277                     only  have  to  change this setting if your configuration
2278                     differs.
2279
2280       /usr/local/share/locale/$LC_MESSAGES/LC_MESSAGES/tin.mo
2281
2282              translation into language specified in $LC_ALL, $LC_MESSAGES  or
2283              $LANG
2284
2285       ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
2286
2287              This  file  lists  the  newsgroups that the local site receives.
2288              Each newsgroup should be listed only once. Each  line  specifies
2289              one  group;  within each newsgroup, articles are assigned unique
2290              names, which are monotonically increasing numbers.
2291
2292              If an article is posted to  newsgroups  not  mentioned  in  this
2293              file,  those newsgroups are ignored.  If no valid newsgroups are
2294              specified, the article is rejected.
2295
2296              Each line consists of four space-separated fields "name highmark
2297              lowmark flags".
2298
2299              name   is the name of the newsgroup
2300
2301              highmark
2302                     is  the highest article number that has been used in that
2303                     newsgroup
2304
2305              lowmark
2306                     is the lowest article number in the group; this number is
2307                     not  guaranteed  to be accurate, and should only be taken
2308                     to be a hint. Note that because of article cancellations,
2309                     there  may be gaps in the numbering sequence. If the low‐
2310                     est article number is greater than  the  highest  article
2311                     number, then there are no articles in the newsgroup.
2312
2313              flags  can be one of those
2314
2315                     y      local postings are allowed
2316
2317                     n      no local postings are allowed, only remote ones
2318
2319                     m      the  group  is  moderated and all postings must be
2320                            approved
2321
2322                     j      articles in this group  are  not  kept,  but  only
2323                            passed on
2324
2325                     x      articles cannot be posted to this newsgroup
2326
2327                     =foo.bar
2328                            articles  are  locally  filed into the ''foo.bar''
2329                            group
2330
2331              tin(1) only tries to read the file if you read directly from the
2332                     local  spool,  if you read news via NNTP, tin(1) uses the
2333                     LIST (RFC3977) or LIST COUNTS (RFC6048) command instead.
2334
2335       ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
2336
2337              This file provides a chronological record of when newsgroups are
2338              created.  It  is normally updated by the local news server (e.g.
2339              innd(8)) whenever a new group is created. Each line  consist  of
2340              three space-separated fields "name time creator".
2341
2342              name   is the name of the newsgroup
2343
2344              time   is  the time when the group was created, expressed as the
2345                     number of seconds since the Epoch.
2346
2347              creator
2348                     is the electronic mail address of the person who  created
2349                     the group.
2350
2351              tin(1) only tries to read the file if you read directly from the
2352                     local spool, if you read news via NNTP, tin(1)  uses  the
2353                     NEWGROUPS (RFC3977) command instead.
2354
2355       ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
2356
2357              This  file  provides short descriptions of each newsgroup. It is
2358              normally updated by the local news server (e.g.  innd(8))  when‐
2359              ever  a new group is created. Each line consist of two tab-sepa‐
2360              rated fields "group.name             one-line description".
2361
2362              group.name
2363                     is the name of the newsgroup
2364
2365              one-line description
2366                     is a short single-line description of the group
2367
2368              tin(1) only tries to read the file if you read directly from the
2369                     local  spool,  if you read news via NNTP, tin(1) uses the
2370                     LIST NEWSGROUPS (RFC3977) command instead.
2371
2372       ${TIN_LIBDIR:-NEWSLIBDIR}/organization
2373
2374              This file might hold a default organization to be  used  in  the
2375              ''Organization:'' header. $ORGANIZATION has a higher priority if
2376              set.
2377
2378       ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
2379
2380              This file specifies the organization of the news overview  data‐
2381              base  (see  also  newsoverview(5)).   The order of lines in this
2382              file is important; it determines the order in which  the  fields
2383              will  appear  in the database. See also overview.fmt(5).  tin(1)
2384              only tries to read the file if you read directly from the  local
2385              spool,  if  you  read  news via NNTP, tin(1) uses the LIST OVER‐
2386              VIEW.FMT (RFC3977) command instead.
2387
2388       ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
2389
2390              This file contains a list of newsgroups — one per line  —  which
2391              the  client should subscribe to when the user has no ${TIN_HOME‐
2392              DIR:-"$HOME"}/.newsrc for the news server.  tin(1) only tries to
2393              read  the file if you read directly from the local spool, if you
2394              read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
2395              command instead.
2396

SEE ALSO

2398       elm(1),  inews(1),  ispell(1),  lp(1),  lpr(1),  metamail(1),  perl(1),
2399       perlre(1), pgp(1),  rn(1),  shar(1),  slrnface(1),  tin(1),  xterm(1x),
2400       heapsort(3),    iconv(3),   iconv_open(3),   nl_langinfo(3),   pcre(3),
2401       pcrepattern(3),   qsort(3),    strftime(3),    system(3),    active(5),
2402       mailcap(5),   mbox(5),   mmdf(5),   newsoverview(5),   overview.fmt(5),
2403       innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980,
2404       RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048
2405
2406
2407
24082.4.4                         December 24th, 2019                       tin(5)
Impressum