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 in 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:''. The matching type used (wild‐
665                     mat  or  regex) depends on the setting of the tinrc vari‐
666                     able wildcard.
667
668              from   Match against ''From:''.  tin(1) converts the contents of
669                     the ''From:'' header to an old style e-mail address, e.g.
670                     ''some@body.example (John Doe)'' instead  of  ''John  Doe
671                     <some@body.example>'',  before  trying  to match the pat‐
672                     terns in the filter rule. The matching type used (wildmat
673                     or  regex)  depends  on the setting of the tinrc variable
674                     wildcard.
675
676              msgid  Match against ''Message-ID:'' and  full  ''References:''.
677                     The  matching type used (wildmat or regex) depends on the
678                     setting of the tinrc variable wildcard.
679
680              msgid_last
681                     Match against ''Message-ID:''  and  last  ''References:''
682                     entry  only.  The  matching  type used (wildmat or regex)
683                     depends on the setting of the tinrc variable wildcard.
684
685              msgid_only
686                     Match against ''Message-ID:''.  The  matching  type  used
687                     (wildmat  or  regex)  depends on the setting of the tinrc
688                     variable wildcard.
689
690              refs_only
691                     Match against ''References:''.  The  matching  type  used
692                     (wildmat  or  regex)  depends on the setting of the tinrc
693                     variable wildcard.
694
695              lines  Match against ''Lines:'', <num matches  less  than,  >num
696                     matches more than.
697
698              gnksa  Match against ''From:'' address parser return codes. <num
699                     matches less than, >num matches more  than  the  returned
700                     numeric      value.     GNKSA_LOCAL_DOMAIN_LITERAL     or
701                     GNKSA_INVALID_DOMAIN   are   only   returned   if    dis‐
702                     able_gnksa_domain_check  is set to false. As the built in
703                     domain list is outdated this should be  considered  care‐
704                     fully.
705                          0  GNKSA_OK
706                          1  GNKSA_INTERNAL_ERROR
707                        100  GNKSA_LANGLE_MISSING
708                        101  GNKSA_LPAREN_MISSING
709                        102  GNKSA_RPAREN_MISSING
710                        103  GNKSA_ATSIGN_MISSING
711                        104  GNKSA_RANGLE_MISSING
712                        200  GNKSA_SINGLE_DOMAIN
713                        201  GNKSA_INVALID_DOMAIN
714                        202  GNKSA_ILLEGAL_DOMAIN
715                        203  GNKSA_UNKNOWN_DOMAIN
716                        204  GNKSA_INVALID_FQDN_CHAR
717                        205  GNKSA_ZERO_LENGTH_LABEL
718                        206  GNKSA_ILLEGAL_LABEL_LENGTH
719                        207  GNKSA_ILLEGAL_LABEL_HYPHEN
720                        208  GNKSA_ILLEGAL_LABEL_BEGNUM
721                        209  GNKSA_BAD_DOMAIN_LITERAL
722                        210  GNKSA_LOCAL_DOMAIN_LITERAL
723                        211  GNKSA_RBRACKET_MISSING
724                        300  GNKSA_LOCALPART_MISSING
725                        301  GNKSA_INVALID_LOCALPART
726                        302  GNKSA_ZERO_LENGTH_LOCAL_WORD
727                        400  GNKSA_ILLEGAL_UNQUOTED_CHAR
728                        401  GNKSA_ILLEGAL_QUOTED_CHAR
729                        402  GNKSA_ILLEGAL_ENCODED_CHAR
730                        403  GNKSA_BAD_ENCODE_SYNTAX
731                        404  GNKSA_ILLEGAL_PAREN_CHAR
732                        405  GNKSA_INVALID_REALNAME
733                        406  GNKSA_MISSING_REALNAME
734
735              xref   Match against ''Xref:'' line. Before any matching is done
736                     the line is turned into the same  format  ''Newsgroups:''
737                     has that is it is turned into a comma separated newsgroup
738                     list  with  all  other  information  (i.e.   the  article
739                     counter)  removed.  The  matching  type  used (wildmat or
740                     regex) depends on the setting of the tinrc variable wild‐
741                     card.
742
743              path   Match  against  ''Path:'' line. This may not work on some
744                     servers.  The  matching  type  used  (wildmat  or  regex)
745                     depends on the setting of the tinrc variable wildcard.
746
747              time   time_t value when rule expires
748
749              Example:
750                     comment=mark all articles about tin, rtin,
751                     comment=tind, ktin or cdtin as hot
752                     group=*
753                     case=1
754                     score=hot
755                     subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
756
757       /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
758       ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
759
760              Keymap-file,  containing "keyname value [value]" pairs separated
761              by spaces or tabs. Below is a list of  all  rebindable  keynames
762              and  their  defaults.  If a keyname is bound to NULL it is unas‐
763              signed.
764
765              ShellEscape                    !
766              SetRange                       #
767              LastPage                       $
768              ToggleColor                    &
769              LastViewed                     -
770              SearchRepeat                   \
771              SearchSubjF                    /
772              SearchSubjB                    ?
773              SearchAuthB                    A
774              SearchBody                     B
775              CatchupNextUnread              C
776              EditFilter                     E
777              ToggleHelpDisplay              H
778              ToggleInverseVideo             I
779              LookupMessage                  L
780              OptionMenu                     M
781              Postponed                      O    ^O
782              QuitTin                        Q
783              BugReport                      R
784              DisplayPostHist                W
785              MarkThrUnread                  Z
786              FirstPage                      ^
787              SearchAuthF                    a
788              Catchup                        c
789              Help                           h
790              ToggleInfoLastLine             i
791              Down                           j    ^N
792              Up                             k    ^P
793              Print                          o
794              Quit                           q
795              Version                        v
796              Post                           w
797              MarkArtUnread                  z
798              QuickFilterSelect              [
799              QuickFilterKill                ]
800              Pipe                           |
801              ScrollUp                       <
802              ScrollDown                     >
803              PageUp                         b    ^B   ^U
804              PageDown                       ^D   ^F   SPACE
805              RedrawScr                      ^L
806              Postponed                      ^O
807              MenuFilterSelect               ^A
808              MenuFilterKill                 ^K
809              MarkFeedRead                   ^X
810              MarkFeedUnread                 ^W
811
812              AttachSelect                   ^J   ^M
813              AttachPipe                     p
814              AttachSave                     s
815              AttachTag                      t
816              AttachUntag                    U
817              AttachTagPattern               =
818              AttachToggleTagged             @
819
820              ConfigToggleAttrib             TAB
821              ConfigSelect                   ^J   ^M
822              ConfigLastPage                 G
823              ConfigNoSave                   Q
824              ConfigScopeMenu                S
825              ConfigFirstPage                g
826              ConfigResetAttrib              r
827
828              FeedTag                        T
829              FeedArt                        a
830              FeedHot                        h
831              FeedPat                        p
832              FeedRepost                     r
833              FeedSupersede                  s
834              FeedThd                        t
835
836              FilterEdit                     e
837              FilterSave                     s
838
839              GroupNextUnreadArtOrGrp        TAB
840              GroupReadBasenote              ^J   ^M
841              GroupSelThd                    *
842              GroupDoAutoSel                 +
843              GroupToggleThdSel              .
844              GroupSelThdIfUnreadSelected    ;
845              GroupSelPattern                =
846              GroupReverseSel                @
847              GroupCancel                    D
848              GroupToggleGetartLimit         G
849              GroupMarkThdRead               K
850              GroupNextUnreadArt             N
851              GroupPrevUnreadArt             P
852              GroupAutoSave                  S
853              GroupTagParts                  T
854              GroupUntag                     U
855              GroupMarkUnselArtRead          X
856              GroupToggleSubjDisplay         d
857              GroupGoto                      g
858              GroupListThd                   l
859              GroupMail                      m
860              GroupNextGroup                 n
861              GroupPrevGroup                 p
862              GroupToggleReadUnread          r
863              GroupSave                      s
864              GroupTag                       t
865              GroupToggleThreading           u
866              GroupRepost                    x
867              GroupUndoSel                   ~
868
869              HelpLastPage                   G
870              HelpFirstPage                  g
871
872              PageReplyQuoteHeaders          ^E
873              PagePGPCheckArticle            ^G
874              PageToggleRaw                  ^H
875              PageNextUnread                 TAB
876              PageNextThd                    ^J   ^M
877              PageToggleTabs                 ^T
878              PageFollowupQuoteHeaders       ^W
879              PageToggleTex2iso              "
880              PageToggleAllHeaders           *
881              PageToggleRot                  %
882              PageToggleUue                  (
883              PageReveal                     )
884              PageSkipIncludedText           :
885              PageTopThd                     <
886              PageBotThd                     >
887              PageCancel                     D
888              PageFollowup                   F
889              PageLastPage                   G
890              PageKillThd                    K
891              PageNextUnreadArt              N
892              PagePrevUnreadArt              P
893              PageReply                      R
894              PageAutoSave                   S
895              PageGroupSel                   T
896              PageViewUrl                    U
897              PageViewAttach                 V
898              PageToggleHighlight            _
899              PageEditArticle                e
900              PageFollowupQuote              f
901              PageFirstPage                  g
902              PageListThd                    l
903              PageMail                       m
904              PageNextArt                    n
905              PagePrevArt                    p
906              PageReplyQuote                 r
907              PageSave                       s
908              PageTag                        t
909              PageGotoParent                 u
910              PageRepost                     x
911
912              PgpEncSign                     b
913              PgpEncrypt                     e
914              PgpIncludekey                  i
915              PgpSign                        s
916
917              PostAbort                      a
918              PostContinue                   c
919              PostCancel                     d
920              PostEdit                       e
921              PostPGP                        g
922              PostIspell                     i
923              PostIgnore                     i
924              PostMail                       m
925              PostPostpone                   o
926              PostPost                       p    y
927              PostSupersede                  s
928              PostSend                       s    y
929
930              PostponeOverride               Y
931              PostponeAll                    A
932
933              PromptYes                      y    Y
934              PromptNo                       n    N
935
936              SaveAppendFile                 a
937              SaveOverwriteFile              o
938
939              PProcNone                      n
940              PProcShar                      s
941              PProcYes                       y
942
943              SelectEnterNextUnreadGrp       TAB  n
944              SelectReadGrp                  ^J   ^M
945              SelectResetNewsrc              ^R
946              SelectSortActive               .
947              SelectNextUnreadGrp            N
948              SelectSubscribePat             S
949              SelectUnsubscribePat           U
950              SelectQuitNoWrite              X
951              SelectSyncWithActive           Y
952              SelectToggleDescriptions       d
953              SelectGoto                     g
954              SelectMoveGrp                  m
955              SelectToggleReadDisplay        r
956              SelectSubscribe                s
957              SelectUnsubscribe              u
958              SelectYankActive               y
959              SelectMarkGrpUnread            z    Z
960
961              ScopeSelect                    ^J   ^M
962              ScopeEditAttributesFile        E
963              ScopeAdd                       a
964              ScopeDelete                    d
965              ScopeMove                      m
966              ScopeRename                    r
967
968              ThreadReadNextArtOrThread      TAB
969              ThreadReadArt                  ^J   ^M
970              ThreadSelArt                   *
971              ThreadToggleArtSel             .
972              ThreadReverseSel               @
973              ThreadCancel                   D
974              ThreadMarkArtRead              K
975              ThreadAutoSave                 S
976              ThreadUntag                    U
977              ThreadToggleSubjDisplay        d
978              ThreadMail                     m
979              ThreadSave                     s
980              ThreadTag                      t
981              ThreadTagParts                 T
982              ThreadUndoSel                  ~
983
984              UrlSelect                      ^J   ^M
985
986       ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
987
988              This  file  provides  short  descriptions  of  each   mailgroup.
989              (requires  tin(1)  to  be  build with mh-mail-handling support).
990              Each line consist of  two  tab-separated  fields  "mailgroupname
991              one-line description".
992
993              mailgroupname
994                     is the name of the newsgroup
995
996              description
997                     is a short single-line description of the group
998
999       ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
1000
1001              "nntpserver  newsrc  [shortname  [...]]"   pairs to use with the
1002              ''-g'' command-line switch.
1003
1004              nntpserver
1005                     full qualified domain name of the news server.
1006
1007              newsrc related newsrc.
1008
1009              shortname
1010                     nickname(s) for the nntpserver.
1011
1012              Example:
1013                     # sample newsrctable file
1014                     news.tin.org .newsrc-tin.org tinorg
1015                     news.example.org /tmp/nrc-ex example ex
1016
1017       ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
1018
1019              posting history
1020
1021       ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
1022
1023              Copy of all posted articles in mbox(5) format. The filename  can
1024              be changed by setting posted_articles_file.
1025
1026       ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
1027
1028              Pool of postponed articles. This file is in mbox(5) format.
1029
1030       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/newsgroups
1031
1032              This  file  a copy of the servers newsgroups file which provides
1033              short  descriptions  of  each  newsgroup.  It  is  automatically
1034              updated  on  startup  except when using the ''-X''or ''-q'' com‐
1035              mand-line option and an old copy exists. Each  line  consist  of
1036              two tab-separated fields "group.name                    one-line
1037              description".
1038
1039              group.name
1040                     is the name of the newsgroup
1041
1042              one-line description
1043                     is a short single-line description of the group
1044
1045       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/serverrc
1046
1047              File to store $NNTPSERVER and $NNTPPORT related data via a  list
1048              of  "variable=value"  pairs.  Currently there are only two vari‐
1049              ables, both are not meant to be changed by the user.
1050
1051              version
1052                     Internal version number.
1053
1054              last_newnews
1055                     Internal timestamp used by tin(1) to keep  track  of  new
1056                     newsgroups on the server.
1057
1058       /etc/tin/tinrc
1059       ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
1060
1061              At  startup,  tin(1)  reads in the configuration file. This con‐
1062              tains a list of "variable=value" pairs that can be used to  con‐
1063              figure the way tin(1) works. If it exists, the global configura‐
1064              tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first.  After
1065              that,    the   user's   own   configuration   file   ${TIN_HOME‐
1066              DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful  for
1067              distributing  system-wide defaults to new users who have no pri‐
1068              vate tinrc yet (see also /etc/tin/tin.defaults).
1069
1070              abbreviate_groupname
1071                     If ON abbreviate long newsgroup names at group  selection
1072                     level   and  article  level  (if  necessary)  like  this:
1073                     news.software.readers -> n.software.readers ->  n.s.read‐
1074                     ers -> n.s.r.  Default is OFF.
1075
1076              add_posted_to_filter
1077                     If  ON  add  posted  articles which start a new thread to
1078                     filter for highlighting follow-ups. Default is ON.
1079
1080              advertising
1081                     Turn ON advertising in header (''User-Agent:'').  Default
1082                     is ON.
1083
1084              alternative_handling
1085                     If ON strip multipart/alternative messages automatically.
1086                     Default is ON.
1087
1088              art_marked_deleted
1089                     The character used to show that an article  was  deleted.
1090                     Default is 'D'.
1091
1092              art_marked_inrange
1093                     The character used to show that an article is in a range.
1094                     Default is '#'.
1095
1096              art_marked_return
1097                     The character used to show that an article will return as
1098                     an unread article when the group is next entered. Default
1099                     is '-'.
1100
1101              art_marked_selected
1102                     The character used to  show  that  an  article/thread  is
1103                     auto-selected (hot).  Default is '*'.
1104
1105              art_marked_recent
1106                     The  character  used  to  show  that an article/thread is
1107                     recent (not older than X  days).  See  also  recent_time.
1108                     Default is 'o'.
1109
1110              art_marked_unread
1111                     The  character  used to show that an article has not been
1112                     read.  Default is '+'.
1113
1114              art_marked_read
1115                     The character used to show  that  an  article  was  read.
1116                     Default is ' '.
1117
1118              art_marked_killed
1119                     The  character  used  to show that an article was killed.
1120                     Default is 'K'.  kill_level must be set accordingly.
1121
1122              art_marked_read_selected
1123                     The character used to show that an article was hot before
1124                     it  was  read.   Default  is  ':'. kill_level must be set
1125                     accordingly.
1126
1127              Ask before using MIME viewer (ask_for_metamail)
1128                     If ON tin(1) will ask before using a MIME  viewer  (meta‐
1129                     mail_prog)  to display MIME messages. This only occurs if
1130                     a MIME viewer is set. Default is OFF.
1131
1132              auto_cc_bcc
1133                     Automatically  put  your  name  in  the  ''Cc:''   and/or
1134                     ''Bcc:'' field when mailing an article. Default is No.
1135
1136              auto_list_thread
1137                     If  ON  automatically  list thread when entering it using
1138                     right arrow key.  Default is ON.
1139
1140              auto_reconnect
1141                     Reconnect to server automatically. Default is OFF.
1142
1143              auto_save
1144                     If ON articles/threads with ''Archive-name:''  in  header
1145                     will  be  automatically  saved  with  the  Archive-name &
1146                     part/patch no and post processed if post_process_type  is
1147                     set to something other than 'No'.  Default is OFF.
1148
1149              batch_save
1150                     If  set  ON  articles/threads will be saved in batch mode
1151                     when save ''-S'' or mail ''-M, -N'' is specified  on  the
1152                     command line. Default is ON.
1153
1154              beginner_level
1155                     If set ON a mini menu of the most useful commands will be
1156                     displayed at the bottom of the  screen  for  each  level.
1157                     Also  a  short  posting etiquette will be displayed after
1158                     composing an article. Default is ON.
1159
1160              cache_overview_files
1161                     If ON, create local copies of NNTP overview  files.  This
1162                     can  be  used  to  considerably  speed up accessing large
1163                     groups when using a slow connection.  Default is OFF.
1164
1165              cancel_lock_algo
1166                     Use this hash algorithm for cancel-locks. Only  available
1167                     when  build  with  cancel-lock support. none disables the
1168                     generation of cancel-locks. Valid values are none,  sha1,
1169                     sha256 and sha512.  Default is sha1.
1170
1171              catchup_read_groups
1172                     If  set  ON the user is asked when quitting if all groups
1173                     read during the current session should  be  marked  read.
1174                     Default is OFF.
1175
1176              col_back
1177                     Standard background color
1178
1179              col_extquote
1180                     Color of quoted text from external sources
1181
1182              col_from
1183                     Color of sender (From:)
1184
1185              col_head
1186                     Color of header-lines
1187
1188              col_help
1189                     Color of help pages
1190
1191              col_invers_bg
1192                     Color of background for inverse text
1193
1194              col_invers_fg
1195                     Color of foreground for inverse text
1196
1197              col_markdash
1198                     Color   of   words   emphasized  like  _this_.  See  also
1199                     word_h_display_marks and word_highlight.
1200
1201              col_markslash
1202                     Color  of  words  emphasized  like   /this/.   See   also
1203                     word_h_display_marks and word_highlight.
1204
1205              col_markstar
1206                     Color   of   words   emphasized  like  *this*.  See  also
1207                     word_h_display_marks and word_highlight.
1208
1209              col_markstroke
1210                     Color  of  words  emphasized  like   -this-.   See   also
1211                     word_h_display_marks and word_highlight.
1212
1213              col_message
1214                     Color of status messages in last line
1215
1216              col_minihelp
1217                     Color of mini help menu
1218
1219              col_newsheaders
1220                     Color of actual news header fields
1221
1222              col_normal
1223                     Standard foreground color
1224
1225              col_quote
1226                     Color of quoted lines
1227
1228              col_quote2
1229                     Color of twice quoted lines
1230
1231              col_quote3
1232                     Color of >=3 times quoted lines
1233
1234              col_response
1235                     Color  of  response  counter.  This is the text that says
1236                     "Response x of y" in the article viewer.
1237
1238              col_signature
1239                     Color of signatures
1240
1241              col_urls
1242                     Color of urls highlight
1243
1244              col_verbatim
1245                     Color of verbatim blocks
1246
1247              col_subject
1248                     Color of article subject
1249
1250              col_text
1251                     Color of text-lines
1252
1253              col_title
1254                     Color of help/mail sign
1255
1256              confirm_choice
1257                     tin(1) can ask for manual  confirmation  to  protect  the
1258                     user. Available choices:
1259                          commands: Ask for confirmation before executing cer‐
1260                          tain dangerous commands (e.g., Catchup ('c')).  Com‐
1261                          mands  that  this  affects are marked in this manual
1262                          with '[after confirmation]'.
1263
1264                          quit: You'll be asked to confirm that  you  wish  to
1265                          exit tin(1) when you use the Quit ('q') command.
1266
1267                          select:  Ask for confirmation before marking all not
1268                          selected (with GroupMarkUnselArtRead ('X')  command)
1269                          articles as read.
1270                     Default is commands & quit.
1271
1272              date_format
1273                     Format string used for date representation. A description
1274                     of  the  different  format  options  can  be   found   at
1275                     strftime(3).   tin(1) uses strftime(3) when available and
1276                     supports  most  format  options  in  his  fallback  code.
1277                     Default is "%a, %d %b %Y %H:%M:%S".
1278
1279              default_art_search
1280
1281              default_author_search
1282
1283              default_config_search
1284                     The  last  article/author/config option that was searched
1285                     for.
1286
1287              default_filter_days
1288                     Default is 28.
1289
1290              default_filter_kill_case
1291                     Default for quick (1 key) kill filter case.  ON =  filter
1292                     case sensitive, OFF = ignore case. Default is OFF.
1293
1294              default_filter_kill_expire
1295                     Default for quick (1 key) kill filter expire.  ON = limit
1296                     to default_filter_days, OFF = don't ever expire.  Default
1297                     is OFF.
1298
1299              default_filter_kill_global
1300                     Default  for  quick (1 key) kill filter global.  ON=apply
1301                     to all groups, OFF=apply to current group. Default is ON.
1302
1303              default_filter_kill_header
1304                     Default for quick (1 key) kill filter header.
1305                        0     ''Subject:'' (case sensitive)
1306                        1     ''Subject:'' (ignore case)
1307                        2     ''From:'' (case sensitive)
1308                        3     ''From:'' (ignore case)
1309                        4     ''Message-ID:'' & full ''References:'' line
1310                        5     ''Message-ID:'' & last ''References:'' entry only
1311                        6     ''Message-ID:'' entry only
1312                        7     ''Lines:''
1313
1314              default_filter_select_case
1315                     Default for quick (1  key)  auto-selection  filter  case.
1316                     ON=filter  case  sensitive,  OFF=ignore  case. Default is
1317                     OFF.
1318
1319              default_filter_select_expire
1320                     Default for quick (1 key) auto-selection  filter  expire.
1321                     ON  =  limit  to  default_filter_days,  OFF  = don't ever
1322                     expire.  Default is OFF.
1323
1324              default_filter_select_global
1325                     Default for quick (1 key) auto-selection  filter  global.
1326                     ON=apply  to  all  groups,  OFF=apply  to  current group.
1327                     Default is ON.
1328
1329              default_filter_select_header
1330                     Default for quick (1 key) auto-selection filter header.
1331                        0     ''Subject:'' (case sensitive)
1332                        1     ''Subject:'' (ignore case)
1333                        2     ''From:'' (case sensitive)
1334                        3     ''From:'' (ignore case)
1335                        4     ''Message-ID:'' & full ''References:'' line
1336                        5     ''Message-ID:'' & last ''References:'' entry only
1337                        6     ''Message-ID:'' entry only
1338                        7     ''Lines:''
1339
1340              default_goto_group
1341
1342              default_group_search
1343
1344              default_mail_address
1345
1346              default_move_group
1347
1348              default_pattern
1349
1350              default_pipe_command
1351
1352              default_post_newsgroups
1353
1354              default_post_subject
1355
1356              default_range_group
1357
1358              default_range_select
1359
1360              default_range_thread
1361
1362              default_repost_group
1363
1364              default_save_file
1365
1366              default_save_mode
1367
1368              default_select_pattern
1369
1370              default_shell_command
1371
1372              default_subject_search
1373
1374              draw_arrow
1375                     Allows groups/articles to be selected by an arrow '->' if
1376                     set  ON  or  by  a highlighted bar if set OFF. Default is
1377                     OFF.
1378
1379              editor_format
1380                     The format string used to create the editor start command
1381                     with  parameters.  Default is '%E +%N %F' with %E=Editor,
1382                     %N=Linenumber and %F=Filename (e.g.,  /bin/vi  +7  .arti‐
1383                     cle).
1384
1385              extquote_handling
1386                     If  ON  quotes  from  external  sources will be detected.
1387                     Default is OFF.
1388
1389              extquote_regex
1390                     A regular expression that will be  applied  when  reading
1391                     articles.  All  matching lines are shown in col_extquote.
1392                     If extquote_regex is blank, then tin(1) uses  a  built-in
1393                     default.
1394
1395              force_screen_redraw
1396                     Specifies  whether  a screen redraw should always be done
1397                     after certain external commands. Default is OFF.
1398
1399              getart_limit
1400                     If  getart_limit  is  >  0  not  more   than   the   last
1401                     getart_limit  articles/group are fetched from the server.
1402                     If getart_limit is < 0 tin(1) will start  fetching  arti‐
1403                     cles  from  your  first  unread  minus  absolute value of
1404                     getart_limit. Default is 0, which means no limit.
1405
1406              goto_next_unread
1407                     Which keys tin(1) should  accept  to  jump  to  the  next
1408                     unread  article.  Possible is any combination of PageDown
1409                     and PageNextUnread.  When PageDown is set tin(1) jumps to
1410                     the  next  article  at  the  end of the current one. When
1411                     PageNextUnread is set tin(1)  jumps  immediately  to  the
1412                     next  article  when  PageNextUnread ('<TAB>') is pressed.
1413                     Default is PageNextUnread.
1414
1415              group_catchup_on_exit
1416                     If ON catchup group when leaving with the left arrow key.
1417                     Default is ON.
1418
1419              group_format
1420                     The  format  string  used for the Group level. Default is
1421                     "%n %m %R %L  %s  %F". The  following  substitutions  are
1422                     supported:
1423                        %D    date
1424                        %F    from, name and/or address
1425                        %I    initials
1426                        %L    line count
1427                        %M    message-id
1428                        %R    number of responses in thread
1429                        %S    score
1430                        %m    article marks
1431                        %n    current thread number
1432                        %s    subject
1433                        %%    %
1434
1435              hide_uue
1436                     If  set  to 'No' then raw uuencoded data is displayed. If
1437                     set to 'Yes' then sections  of  uuencoded  data  will  be
1438                     shown  with  a single tag line showing the size and file‐
1439                     name (much the same as a MIME  attachment).   If  set  to
1440                     'Hide  all'  then any line that looks like uuencoded data
1441                     will be folded into a tag line. This is useful when uuen‐
1442                     coded  data is split across more than one article but can
1443                     also lead to false positives. This setting  can  also  be
1444                     toggled in the article viewer.  Default is 'No'.
1445
1446              inews_prog
1447                     Path,  name and options of external inews(1).  If you are
1448                     reading via NNTP the default value is  "--internal"  (use
1449                     built-in  NNTP inews), else it is "inews -h". The article
1450                     is passed to inews_prog on STDIN via '< article'.
1451
1452              info_in_last_line
1453                     If ON, show current group description or article  subject
1454                     in  the  last  line  (not in the pager and global menu) —
1455                     ToggleInfoLastLine ('i') toggles setting.  This  facility
1456                     is useful as the full width of the screen is available to
1457                     display long subjects. Default is OFF.
1458
1459              interactive_mailer
1460                     If greater than 0 your mailreader will be invoked earlier
1461                     for reply so you can use more of its features (e.g. MIME,
1462                     pgp, ...). 1 means include headers, 2 means don't include
1463                     headers  (old  use_mailreader_i=ON  option).  0 turns off
1464                     usage. This option has to suit mailer_format. Default  is
1465                     0.
1466
1467              inverse_okay
1468                     If  ON  use  inverse video for page headers and URL high‐
1469                     lighting.  Default is ON.
1470
1471              keep_dead_articles
1472                     If  ON  keep   all   failed   postings   in   ${TIN_HOME‐
1473                     DIR:-"$HOME"}/dead.articles   besides  keeping  the  last
1474                     failed posting  in  ${TIN_HOMEDIR:-"$HOME"}/dead.article.
1475                     Default is ON.
1476
1477              kill_level
1478                     This  option controls the processing and display of arti‐
1479                     cles that are killed. There are 3 options, default  is  0
1480                     (Kill only unread arts).
1481
1482                        0  Kill only unread arts is the 'traditional' behavior
1483                           of tin(1).  Only unread articles  are  killed  once
1484                           only  by  marking them read. As filtering only hap‐
1485                           pens on unread articles with kill_level set  to  0,
1486                           art_marked_killed  and art_marked_read_selected are
1487                           only shown once. When you  reenter  the  group  the
1488                           mark will be gone.
1489
1490                        1  Kill  all arts & show with K will process all arti‐
1491                           cles in the group and therefore there is a process‐
1492                           ing  overhead  when using this option. Killed arti‐
1493                           cles are threaded as normal but they will be marked
1494                           with art_marked_killed.
1495
1496                        2  Kill all arts and never show will process all arti‐
1497                           cles in the group and therefore there is a process‐
1498                           ing  overhead  when using this option. Killed arti‐
1499                           cles simply does not get displayed at all.
1500
1501              mail_8bit_header
1502                     Allows 8bit characters unencoded in the  header  of  mail
1503                     message.  Default is OFF. Turning it ON is effective only
1504                     if mail_mime_encoding is also set to 8bit. Leaving it OFF
1505                     is  safe  for  most  users and compliant to Internet Mail
1506                     Standard (RFC5322 and RFC2047). Default is OFF.
1507
1508              mail_address
1509                     User's  mail  address  (and  full  name),  if  not  user‐
1510                     name@host.  This  is used when creating articles, sending
1511                     mail and when pgp(1) signing.
1512
1513              mail_mime_encoding
1514                     MIME encoding of the body in mail message,  if  necessary
1515                     (8bit,   base64,   quoted-printable,  7bit).  Default  is
1516                     quoted-printable.
1517
1518              mail_quote_format
1519                     Format of quote line when replying (via mail) to an arti‐
1520                     cle  (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1521                     name, %M=Message-ID, %N=Fullname,  %C=Firstname,  %I=Ini‐
1522                     tials). Default is "In article %M you wrote:"
1523
1524              mailbox_format
1525                     Select   one  of  the  following  mailbox-formats:  MBOXO
1526                     (default, except on SCO),  MBOXRD  or  MMDF  (default  on
1527                     SCO).  See  mbox(5) and RFC4155 for more details on MBOXO
1528                     and MBOXRD and mmdf(5) for more details about MMDF.
1529
1530              maildir
1531                     The directory where articles/threads are to be  saved  in
1532                     mbox(5)  format.  This feature is mainly for use with the
1533                     elm(1) mail program. It allows the  user  to  save  arti‐
1534                     cles/threads/groups  simply by giving '=' as the filename
1535                     to save to.  Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.
1536
1537              mailer_format
1538                     The format string used to create the mailer command  with
1539                     parameters  that  is  used  for mailing articles to other
1540                     people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1541                     <  .article).  The  flexible  format allows other mailers
1542                     with different command line parameters to be used such as
1543                        sendmail -oem -t < %F
1544                        elm -s "%S" "%T" < "%F"
1545                        claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1546                     interactive_mailer must be set  adequate.  The  following
1547                     substitutions are supported:
1548                        %F              filename
1549                        %M              default_mailer
1550                        %S              subject-field
1551                        %T              to-filed
1552                        %U              username
1553                        %%              %
1554
1555              mark_saved_read
1556                     If  ON  mark  articles that are saved as read. Default is
1557                     ON.
1558
1559              mark_ignore_tags
1560                     When this is  ON,  the  GroupMarkThdRead  ('K'),  Thread‐
1561                     MarkArtRead ('K'), MarkThdUnread ('Z') at Group level and
1562                     MarkArtUnread ('z') at Thread level functions  mark  just
1563                     the  current  article  or  thread, ignoring other tagged,
1564                     (un)read articles. When OFF, the same function presents a
1565                     menu  with  choices of the current thread or article, all
1566                     tagged, unread articles, or nothing.
1567
1568              metamail_prog
1569                     Path, name and options of  external  metamail(1)  program
1570                     used  to  view non-textual parts of articles.  To use the
1571                     built-in viewer, set to --internal. This is  the  default
1572                     value  when  metamail(1) is not installed. Leave it blank
1573                     if you don't want any automatic  viewing  of  non-textual
1574                     attachments.  The 'V' command can always be used to manu‐
1575                     ally view any attachments. See also ask_for_metamail.
1576
1577              mm_charset
1578                     Charset supported locally, which is also  used  for  MIME
1579                     header  (charset  parameter  and  charset  name in header
1580                     encoding)    in    mail    and    news    postings.    If
1581                     MIME_STRICT_CHARSET  is  defined at compile time, text in
1582                     charset other than the value of this parameter is consid‐
1583                     ered  not  displayable and represented as '?'. Otherwise,
1584                     all character sets are regarded as  compatible  with  the
1585                     display.  If  it's  not set, the value of the environment
1586                     variable $MM_CHARSET is used.  US-ASCII  or  compile-time
1587                     default  is  used  in case neither of them is defined. If
1588                     your system supports iconv(3), this  option  is  disabled
1589                     and you should use mm_network_charset instead.
1590
1591              mm_network_charset
1592                     Charset  used  for  posting  and  MIME  headers; replaces
1593                     mm_charset.  Conversion  between  mm_network_charset  and
1594                     local charset (determined via nl_langinfo(3)) is done via
1595                     iconv(3), if this function is not available on your  sys‐
1596                     tem   this  option  is  disabled  and  you  have  to  use
1597                     mm_charset instead. mm_network_charset is limited to  one
1598                     of the following charsets:
1599                        US-ASCII,     ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1600                        KOI8-{R,U,RU}   EUC-{CN,JP,KR,TW},    ISO-2022-{CN,CN-
1601                        EXT,JP,JP-1,JP-2}, Big5, UTF-8
1602                     Not   all   values   might   work  on  your  system,  see
1603                     iconv_open(3) for more details.  If  it's  not  set,  the
1604                     value  of  the  environment variable $MM_CHARSET is used.
1605                     US-ASCII or compile-time default is used in case  neither
1606                     of them is defined.
1607
1608              mono_markdash
1609                     Character  attribute  of words emphasized like _this_. It
1610                     depends on your terminal which attributes are usable. See
1611                     also word_h_display_marks and word_highlight.
1612
1613              mono_markslash
1614                     Character  attribute  of words emphasized like /this/. It
1615                     depends on your terminal which attributes are usable. See
1616                     also word_h_display_marks and word_highlight.
1617
1618              mono_markstar
1619                     Character  attribute  of words emphasized like *this*. It
1620                     depends on your terminal which attributes are usable. See
1621                     also word_h_display_marks and word_highlight.
1622
1623              mono_markstroke
1624                     Character  attribute  of words emphasized like -this-. It
1625                     depends on your terminal which attributes are usable. See
1626                     also word_h_display_marks and word_highlight.
1627
1628              newnews
1629                     These are internal timers used by tin(1) to keep track of
1630                     new newsgroups. Do not change them unless you  understand
1631                     what they are for.
1632
1633              news_headers_to_display
1634                     Which  news  headers  you wish to see. If you want to see
1635                     _all_ the headers, place an '*' as this  value.  This  is
1636                     the  only  way a wildcard can be used.  If you enter 'X-'
1637                     as the value, you will see  all  headers  beginning  with
1638                     'X-'  (like X-Alan or X-Pape). You can list more than one
1639                     by delimiting with spaces. Not  defining  anything  turns
1640                     off this option.
1641
1642              news_headers_to_not_display
1643                     Same  as  news_headers_to_display  except  it denotes the
1644                     opposite. An example of using both options  might  be  if
1645                     you  thought  'X-'  headers  were  A  Good Thing(tm), but
1646                     thought Alan and Pape were miscreants...  well  then  you
1647                     would  do something like this: news_headers_to_display=X-
1648                     news_headers_to_not_display=X-Alan  X-Pape  Not  defining
1649                     anything turns off this option.
1650
1651              news_quote_format
1652                     Format of quote line when posting/following up an article
1653                     (%A=Address, %D=Date, %F=Fullname+Address,  %G=Groupname,
1654                     %M=Message-ID,  %N=Fullname,  %C=Firstname, %I=Initials).
1655                     Default is "%F wrote:".
1656
1657              nntp_read_timeout_secs
1658                     Time in seconds to wait for a response from  the  server.
1659                     Default is 120.
1660
1661              normalization_form
1662                     The  normalization form which should be used to normalize
1663                     unicode input.  The possible values are:
1664
1665                        0  None: no normalization
1666
1667                        1  NFKC:  Compatibility  Decomposition,  followed   by
1668                           Canonical Composition
1669
1670                        2  NFKD: Compatibility Decomposition
1671
1672                        3  NFC: Canonical Decomposition, followed by Canonical
1673                           Composition
1674
1675                        4  NFD: Canonical Decomposition
1676
1677                        5  NFKC_CF: Compatibility Decomposition,  followed  by
1678                           Canonical Composition and Case Folding
1679              Some  normalization  modes  are  only available if they are sup‐
1680              ported by the library tin(1) uses to do the  normalization.  NFC
1681              should be used if possible.
1682
1683              pos_first_unread
1684                     If  ON put cursor at first unread article in group other‐
1685                     wise at last article. Default is ON.
1686
1687              post_8bit_header
1688                     Allows 8bit characters unencoded in the header of a  news
1689                     article,  if  set  this  also  disables the generation of
1690                     MIME-headers when they are usually required.  Default  is
1691                     OFF.  Only  enacted  if post_mime_encoding is also set to
1692                     8bit. In a number of local hierarchies where 8bit charac‐
1693                     ters  are  used, using unencoded (raw) 8bit characters in
1694                     header is acceptable and sometimes  even  recommended  so
1695                     that  you  need  to  check  the convention adopted in the
1696                     local hierarchy of your interest to determine what to  do
1697                     with this and post_mime_encoding.
1698
1699              post_mime_encoding
1700                     MIME  encoding of the body in news message, if necessary.
1701                     (8bit, base64, quoted-printable, 7bit). Default is  8bit,
1702                     which  leads to no encoding.  base64 and quoted-printable
1703                     are usually undesired on usenet.
1704
1705              post_process_view
1706                     If ON, then tin(1) will start an appropriate viewer  pro‐
1707                     gram  to  display  any files that were post processed and
1708                     uudecoded. The program is determined using the mailcap(5)
1709                     file. Default is ON.
1710
1711              post_process_type
1712                     This  specifies  whether  to  perform  post processing on
1713                     saved articles.  Because the shell  archive  may  contain
1714                     commands you may not want to be executed, be careful when
1715                     extracting shell  archives.   The  following  values  are
1716                     allowed:
1717
1718                        0  No (default), no post processing is done.
1719
1720                        1  Shell  archives,  unpacking  of  multi-part shar(1)
1721                           files only. Because the shell archive  may  contain
1722                           commands  you may not want to be executed, be care‐
1723                           ful with this option.
1724
1725                        2  Yes, binary attachments and data  will  be  decoded
1726                           and saved.
1727
1728              posted_articles_file
1729                     Keep posted articles in given file. If the given filename
1730                     does not contain any expandable strings it will  be  pre‐
1731                     fixed  with ${TIN_HOMEDIR:-"$HOME"}/Mail/. If no filename
1732                     is set then postings will not be saved. See  the  section
1733                     "MAILING  PIPING  PRINTING REPOSTING AND SAVING ARTICLES"
1734                     for more information about the various expansion  charac‐
1735                     ters. Default is 'posted'.
1736
1737              print_header
1738                     If  ON,  then  the  full  article  header  is sent to the
1739                     printer. Otherwise only the  ''Subject:''  and  ''From:''
1740                     fields are output. Default is OFF.
1741
1742              printer
1743                     The  printer  program  with options that is to be used to
1744                     print articles. The default is lpr(1)  for  BSD  machines
1745                     and  lp(1)  for  SysV  machines. Printing from tin(1) may
1746                     have been disabled by the System Administrator.
1747
1748              process_only_unread
1749                     If ON only save/print/pipe/mail unread  articles  (tagged
1750                     articles excepted).  Default is OFF.
1751
1752              prompt_followupto
1753                     If  ON show empty ''Followup-To:'' header when editing an
1754                     article.  Default is OFF.
1755
1756              quote_chars
1757                     The character used in quoting included  text  to  article
1758                     followups  and mail replies. The '_' character represents
1759                     a blank character and is replaced with ' ' when read,  %I
1760                     is replaced by author's initials. Default is '>_'.
1761
1762              quote_style
1763                     This bit coded integer value controls how articles are to
1764                     be quoted when following up or replying to them.  Any  of
1765                     the following options can be combined by adding all rele‐
1766                     vant values. Default is 5, which means that quote charac‐
1767                     ters are compressed and empty lines are quoted.
1768
1769                        1  Compress  quotes Compress quote characters together
1770                           when quoting multiple times (for example, '>  >  >'
1771                           will  be  turned  into '>>>'). This option is on by
1772                           default.
1773
1774                        2  Quote Signatures This option  is  off  by  default.
1775                           Signatures  are  always  quoted  regardless of this
1776                           option when you are viewing an article in raw  mode
1777                           PageToggleRaw  ('^H')  and followup or reply to it.
1778                           Signatures are  never  quoted  regardless  of  this
1779                           option when show_signatures is off.
1780
1781                        4  Quote empty lines This option is on by default.
1782
1783              quote_regex
1784                     A  regular  expression  that will be applied when reading
1785                     articles. All matching lines are shown in  col_quote.  If
1786                     quote_regex   is  blank,  then  tin(1)  uses  a  built-in
1787                     default.
1788
1789              quote_regex2
1790                     A regular expression that will be  applied  when  reading
1791                     articles.  All matching lines are shown in col_quote2. If
1792                     quote_regex2  is  blank,  then  tin(1)  uses  a  built-in
1793                     default.
1794
1795              quote_regex3
1796                     A  regular  expression  that will be applied when reading
1797                     articles. All matching lines are shown in col_quote3.  If
1798                     quote_regex3  is  blank,  then  tin(1)  uses  a  built-in
1799                     default.
1800
1801              recent_time
1802                     If set to 0, this feature is  deactivated,  otherwise  it
1803                     means the number of days. Default is 2.
1804
1805              render_bidi
1806                     If  ON  tin(1) does the rendering of bi-directional text.
1807                     If OFF tin(1) leaves the rendering of bi-directional text
1808                     to the terminal. Default is OFF.
1809
1810              reread_active_file_secs
1811                     The     news    ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1812                     FILE:-active} file is reread at regular intervals to show
1813                     if  any  new  news  has arrived. Default is 1200. Setting
1814                     this to 0 will disable this feature.
1815
1816              savedir
1817                     Directory where articles/threads are  saved.  Default  is
1818                     ${TIN_HOMEDIR:-"$HOME"}/News.
1819
1820              score_limit_kill
1821                     If  the  score of an article is below or equal this value
1822                     the article gets marked as killed.
1823
1824              score_limit_select
1825                     If the score of an article is above or equal  this  value
1826                     the article gets marked as hot.
1827
1828              score_kill
1829                     Score  of an article which should be killed, this must be
1830                     <= score_limit_kill.
1831
1832              score_select
1833                     Score of an article which should be marked hot, this must
1834                     be >= score_limit_select.
1835
1836              scroll_lines
1837                     The  number of lines that will be scrolled up/down in the
1838                     article pager when using cursor-up/down. The default is 1
1839                     (line-by-line).  Set to 0 to get traditional tin page-by-
1840                     page scrolling. Set to -1 to get  page-by-page  scrolling
1841                     where  the  top/bottom line is carried over onto the next
1842                     page.           This          setting          supersedes
1843                     show_last_line_prev_page=ON.  Set  to -2 to get half-page
1844                     scrolling. This setting supersedes full_page_scroll=OFF.
1845
1846              select_format
1847                     The format string used for the Selection  level.  Default
1848                     is  "%f %n %U  %G  %d".  The  following substitutions are
1849                     supported:
1850                        %G    group name
1851                        %U    unread count
1852                        %d    description
1853                        %f    group flag
1854                        %n    current group number
1855                        %%    %
1856
1857              sort_function
1858                     Function used for sorting articles. Default is 0.
1859
1860                   0  Use qsort(3) for sorting.
1861
1862                   1  Use heapsort(3) for sorting. This  might  be  faster  in
1863                      large  groups  with  long  threads  (somewhat  presorted
1864                      data).
1865
1866              show_author
1867                     Which information  about  the  author  should  be  shown.
1868                     Default is 2, authors full name.
1869
1870                        0  None, only the ''Subject:'' line will be displayed.
1871
1872                        1  Address,  ''Subject:''  line  & the address part of
1873                           the ''From:'' line are displayed.
1874
1875                        2  Full Name, ''Subject:'' line  &  the  authors  full
1876                           name  part  of  the  ''From:''  line  are displayed
1877                           (default).
1878
1879                        3  Address and Name, ''Subject:'' line &  all  of  the
1880                           ''From:'' line are displayed.
1881
1882              show_description
1883                     If ON show a short group description text after newsgroup
1884                     name at the group selection level.  The  ''-d''  command-
1885                     line flag will override the setting and turn descriptions
1886                     off.  The  text  used  is  taken  from   the   ${TIN_LIB‐
1887                     DIR:-NEWSLIBDIR}/newsgroups   file   and   if   supported
1888                     (requires tin(1) to be build with  mh-mail-handling  sup‐
1889                     port)  from  ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups  for
1890                     mailgroups. Default is ON.
1891
1892              show_info
1893                     Which information about the thread or article  should  be
1894                     shown. Default is 1, show only the line count.
1895
1896                        0  None, no information will be displayed.
1897
1898                        1  Lines,  in  article  listing  the  line count of an
1899                           article will be displayed and in thread listing the
1900                           line  count  of first (unread) article will be dis‐
1901                           played.
1902
1903                        2  Score, in article listing the score of  an  article
1904                           will  be  displayed and in thread listing the score
1905                           of  the  thread  will  be  displayed  —  see   also
1906                           thread_score.
1907
1908                        3  Lines & Score, display line count and score.
1909
1910              show_only_unread_arts
1911                     If  ON  show  only new/unread articles otherwise show all
1912                     articles.  Default is ON.
1913
1914              show_only_unread_groups
1915                     If ON show only subscribed  groups  that  contain  unread
1916                     articles. Default is OFF.
1917
1918              show_signatures
1919                     If  OFF  don't  show signatures when displaying articles.
1920                     Default is ON.
1921
1922              sigdashes
1923                     If ON prepend the signature with  sigdashes.  Default  is
1924                     ON.
1925
1926              sigfile
1927                     The  path  that  specifies the signature file to use when
1928                     posting, following up to or replying to  an  article.  If
1929                     the  path  is a directory then the signature will be ran‐
1930                     domly generated from files  that  are  in  the  specified
1931                     directory.  If  the  path starts with a ! the program the
1932                     path points to will be executed to generate a  signature.
1933                     In order to pass the group name to the program, %G can be
1934                     specified. This will be replaced by the name of the  cur‐
1935                     rent  newsgroup.  --none  will  suppress  any  signature.
1936                     Default is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
1937
1938              signature_repost
1939                     If ON add signature to reposted articles. Default is ON.
1940
1941              slashes_regex
1942                     A regular expression that will be  applied  when  reading
1943                     articles.  All  matching words are shown in col_markslash
1944                     or mono_markslash. If slashes_regex is blank, then tin(1)
1945                     uses a built-in default.
1946
1947              sort_article_type
1948                     This  specifies  how  articles  should be sorted. Sort by
1949                     ascending Date (6) is the  default.  The  following  sort
1950                     types are allowed:
1951
1952                        0  Nothing, don't sort articles.
1953
1954                        1  Subject:  (descending),  sort  articles  by  ''Sub‐
1955                           ject:'' field descending.
1956
1957                        2  Subject: (ascending), sort articles by ''Subject:''
1958                           field ascending.
1959
1960                        3  From:  (descending),  sort  articles  by  ''From:''
1961                           field descending.
1962
1963                        4  From: (ascending), sort articles by ''From:'' field
1964                           ascending.
1965
1966                        5  Date:  (descending),  sort  articles  by  ''Date:''
1967                           field descending.
1968
1969                        6  Date: (ascending), sort articles by ''Date:'' field
1970                           ascending (default).
1971
1972                        7  Score  (descending),  sort  articles  by  filtering
1973                           score descending.
1974
1975                        8  Score (ascending), sort articles by filtering score
1976                           ascending.
1977
1978                        9  Lines:  (descending),  sort  articles by ''Lines:''
1979                           field descending.
1980
1981                        10 Lines: (ascending),  sort  articles  by  ''Lines:''
1982                           field ascending.
1983
1984              sort_threads_type
1985                     This  specifies  how  threads  will  be  sorted.  Sort by
1986                     descending Score (1) is the default. The  following  sort
1987                     types are allowed:
1988
1989                        0  Nothing, don't sort threads.
1990
1991                        1  Score (descending), sort threads by filtering score
1992                           descending (default).
1993
1994                        2  Score (ascending), sort threads by filtering  score
1995                           ascending.
1996
1997                        3  Last  posting  date  (descending),  sort threads by
1998                           date of last posting descending.
1999
2000                        4  Last posting date (ascending), sort threads by date
2001                           of last posting ascending.
2002
2003              spamtrap_warning_addresses
2004                     Set  this  option to a list of comma-separated strings to
2005                     be warned if you are replying to an article by mail where
2006                     the  e-mail  address  contains  one of these strings. The
2007                     matching is case-insensitive. Example:
2008
2009                     spam,delete,remove
2010
2011              stars_regex
2012                     A regular expression that will be  applied  when  reading
2013                     articles. All matching words are shown in col_markstar or
2014                     mono_markstar. If stars_regex is blank, then tin(1)  uses
2015                     a built-in default.
2016
2017              start_editor_offset
2018                     Set ON if the editor used for posting, follow-ups and bug
2019                     reports has the capability of  starting  and  positioning
2020                     the  cursor at a specified line within a file. Default is
2021                     ON.
2022
2023              strip_blanks
2024                     Strips the blanks from the end  of  each  line  therefore
2025                     speeding  up  the display when reading on a slow terminal
2026                     or via modem. Default is ON.
2027
2028              strip_bogus
2029                     Bogus  groups  are  groups  that  are  present  in   your
2030                     ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
2031                     on the news server. There are 3 options. 0 means do noth‐
2032                     ing  &  always  keep  bogus groups.  1 means bogus groups
2033                     will be permanently removed. 2 means  that  bogus  groups
2034                     will  appear on the Group Selection Menu, prefixed with a
2035                     'D'. This allows you to unsubscribe from them as and when
2036                     you wish. Default is 0 (Always Keep).
2037
2038              strip_newsrc
2039                     If  ON,  then  unsubscribed  groups  will  be permanently
2040                     removed from your  ${TIN_HOMEDIR:-"$HOME"}/.newsrc  file.
2041                     Default is OFF.
2042
2043              strip_re_regex
2044                     A  regular expression to find Subject prefixes like "Re:"
2045                     to remove If strip_re_regex is blank, then tin(1) uses  a
2046                     built-in default.
2047
2048              strip_was_regex
2049                     A  regular  expression  to  find  Subject  suffixes  like
2050                     "(was:" to remove.  If  strip_was_regex  is  blank,  then
2051                     tin(1) uses a built-in default.
2052
2053              strokes_regex
2054                     A  regular  expression  that will be applied when reading
2055                     articles. All matching words are shown in  col_markstroke
2056                     or  mono_markstroke.   If  strokes_regex  is  blank, then
2057                     tin(1) uses a built-in default.
2058
2059              tex2iso_conv
2060                     Decode German style TeX umlaut codes to ISO If  ON,  show
2061                     "a  as  Umlaut-a,  etc. Default is OFF. This behavior can
2062                     also be toggled in the  article  viewer  via  PageToggle‐
2063                     Tex2iso ('"').
2064
2065              thread_articles
2066                     Defines  which  threading method to use. The choices are:
2067                     0) Don't thread, 1) Thread on Subject only 2)  Thread  on
2068                     References  only,  3)  Thread  on References then Subject
2069                     (default) 4) Thread multipart articles  on  Subject.   5)
2070                     Thread on Percentage Match of the Subjects It's also pos‐
2071                     sible to set the threading type on a per group  basis  by
2072                     setting the group attribute variable thread_articles to 0
2073                     – 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.
2074
2075              thread_format
2076                     The format string used for the Thread level.  Default  is
2077                     "%n %m  [%L]  %T  %F".  The  following  substitutions are
2078                     supported:
2079                        %D    date
2080                        %F    from, name and/or address
2081                        %I    initials
2082                        %L    line count
2083                        %M    message-id
2084                        %S    score
2085                        %T    thread tree
2086                        %m    article marks
2087                        %n    current article number
2088                        %%    %
2089
2090              thread_perc
2091                     Defines how close the subjects must match while threading
2092                     by  Percentage Match for threads to be considered part of
2093                     a single thread. This value is in the range 0 to 100. The
2094                     default is 75.
2095
2096              thread_catchup_on_exit
2097                     If  ON  catchup  group/thread  when leaving with the left
2098                     arrow key. Default is ON.
2099
2100              thread_score
2101                     How the total score of a thread is computed.  Default  is
2102                     0, the maximum score in this thread.
2103
2104                        0  Max, the maximum score in this thread.
2105
2106                        1  Sum, the sum of all scores in this thread.
2107
2108                        2  Average, the average score in this thread.
2109
2110              translit
2111                     If   ON  append  //TRANSLIT  to  the  first  argument  of
2112                     iconv_open(3) to enable transliteration. This means  that
2113                     when  a  character  cannot  be  represented in the target
2114                     character set, it can be approximated through one or sev‐
2115                     eral  similarly looking characters. On systems where this
2116                     extension doesn't exist, this option is disabled. Default
2117                     is OFF.
2118
2119              trim_article_body
2120                     Allows  you  to  select  how tin(1) treats blank lines in
2121                     article bodies.  Default  is  0.  This  option  does  not
2122                     affect lines within verbatim blocks.
2123
2124                        0  Don't trim article body, do nothing.
2125
2126                        1  Skip leading blank lines.
2127
2128                        2  Skip trailing blank lines.
2129
2130                        3  Skip  leading  and  trailing blank l., skip leading
2131                           and trailing blank lines.
2132
2133                        4  Compact multiple  between  text,  replace  multiple
2134                           blank lines between textblocks with one blank line.
2135
2136                        5  Compact multiple and skip leading, 4 + 1
2137
2138                        6  Compact multiple and skip trailing, 4 + 2
2139
2140                        7  Compact mltpl., skip lead. & trai., 4 + 3
2141
2142              underscores_regex
2143                     A  regular  expression  that will be applied when reading
2144                     articles. All matching words are shown in col_markdash or
2145                     mono_markdash. If underscores_regex is blank, then tin(1)
2146                     uses a built-in default.
2147
2148              unlink_article
2149                     If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post‐
2150                     ing. Default is ON.
2151
2152              url_handler
2153                     The  program  that will be run when launching URLs in the
2154                     article viewer using PageViewUrl ('U').  The  actual  URL
2155                     will be appended.  Default is url_handler.pl.
2156
2157              url_highlight
2158                     Enable highlighting URLs in message body. Default is ON.
2159
2160              use_color
2161                     If enabled tin(1) uses ANSI-colors. Default is OFF.
2162
2163              use_keypad
2164                     Use scroll keys on keypad. Default is OFF.
2165
2166              use_mouse
2167                     Allows  the  mouse  button  support in an xterm(1x) to be
2168                     enabled/disabled.  Default is OFF.
2169
2170              use_slrnface
2171                     If enabled slrnface(1) will  be  used  to  interpret  the
2172                     ''X-Face:''  header.  For this option to have any effect,
2173                     tin(1) must be running in an  xterm(1x)  and  slrnface(1)
2174                     must be in your $PATH. Default is OFF.
2175
2176              utf8_graphics
2177                     If   ON   use  UTF-8  characters  for  indicator  ('->'),
2178                     thread/attachment tree and ellipsis ('...').  Default  is
2179                     OFF.
2180
2181              verbatim_begin_regex
2182                     A  regular expression that tin will use to find the begin
2183                     of a verbatim block.  Default is #v+
2184
2185              verbatim_end_regex
2186                     A regular expression that tin will use to find the end of
2187                     a verbatim block.  Default is #v-
2188
2189              verbatim_handling
2190                     If ON verbatim blocks will be detected. Default is ON.
2191
2192              wildcard
2193                     Allows  you  to  select  how  tin(1) matches strings. The
2194                     default is 0 and uses the wildmat notation, which is  how
2195                     this  has  traditionally been handled.  Setting this to 1
2196                     allows you to use perl(1) compatible regular  expressions
2197                     pcre(3).   (see  also perlre(1) and pcrepattern(3)).  You
2198                     will probably want to update your filter file if you  use
2199                     this  regularly.   NB:  Newsgroup  names  will  always be
2200                     matched using the wildmat notation.
2201
2202              word_h_display_marks
2203                     Should the leading and ending stars, slashes, strokes and
2204                     dashes also be displayed, even when they are highlighting
2205                     marks?
2206
2207                        0  no
2208
2209                        1  yes, display mark
2210
2211                        2  print a space instead
2212
2213              word_highlight
2214                     Enable word highlighting.  See  word_h_display_marks  for
2215                     the options available. If use_color is enabled the colors
2216                     specified in  col_markdash,  col_markslash,  col_markstar
2217                     and  col_markstroke  are  used for word highlighting else
2218                     the  character  attributes  specified  in  mono_markdash,
2219                     mono_markslash,  mono_markstar  and  mono_markstroke  are
2220                     used. Default is ON.
2221
2222              wrap_column
2223                     Sets the column at which a displayed article body  should
2224                     be  wrapped.  If this value is equal to 0, it defaults to
2225                     the current screen width.  If this value is greater  than
2226                     your current screen width the part off-screen is not dis‐
2227                     played. Thus setting this option to a large value can  be
2228                     used  to  disable wrapping. If this value is negative the
2229                     wrap margin is the current screen width  plus  the  given
2230                     value (as long as the result is still positive, otherwise
2231                     it will fall back to the current screen  width).  Default
2232                     is 0, wrapping at the current screen width.
2233
2234              wrap_on_next_unread
2235                     If enabled a search for the next unread article will wrap
2236                     around all articles to find also  previous  unread  arti‐
2237                     cles.  If  disabled  the  search  stops at the end of the
2238                     thread list. Default is ON.
2239
2240              xpost_quote_format
2241                     Format is the same as for news_quote_format, this is used
2242                     when  answering  to a crossposting to several groups with
2243                     no ''Followup-To:'' set.
2244
2245       /etc/tin/tin.defaults
2246
2247              Yet another  global  configuration  file  with  "variable=value"
2248              pairs.  This  one  is for the more general options which usually
2249              can't be controlled via  ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc  and/or
2250              ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc  like  resetting (to override
2251              the built-in default) the newslibdir.
2252
2253              domainname
2254                     Sets a global domain name used in From lines
2255
2256              organization
2257                     Defines the  name  of  your  organization.  $ORGANIZATION
2258                     overrides any specified value.
2259
2260              newslibdir
2261                     Defines  the  default place for some configuration files,
2262                     common   values   are    /usr/lib/news,    /var/lib/news,
2263                     /usr/local/lib/news  or  /news/db.  $TIN_LIBDIR overrides
2264                     any specified value.
2265
2266              bugaddress
2267                     Defines the email address to which  users  can  send  bug
2268                     reports  using a built-in function. The default points to
2269                     a developers mailing list located at tin.org.  You  might
2270                     want to change this address to one of your local adminis‐
2271                     tration if you want to deal with your lusers problems  on
2272                     your own.
2273
2274              inewsdir
2275                     Defines the directory containing the inews(1) executable.
2276
2277              mm_charset
2278                     Default  charset  to  be used in MIME's ''Content-Type:''
2279                     header. $MM_CHARSET overrides any specified value.
2280
2281              post_mime_encoding
2282                     Default encoding scheme used in MIME articles. 8bit might
2283                     be the best value.
2284
2285              mail_mime_encoding
2286                     Default   encoding   scheme   used   in   MIME   letters.
2287                     quoted-printable is a good choice here.
2288
2289              disable_gnksa_domain_check
2290                     Allow unregistered top level  domains.  As  the  list  of
2291                     valid  TLDs  is no longer actively maintained the default
2292                     was changed to ON starting with tin(1) version 2.1.5
2293
2294              disable_sender
2295                     Don't generate a ''Sender:'' header. This has  an  effect
2296                     only if inews_prog is set to --internal.
2297
2298              spooldir
2299                     Base  of your newsspool (Bnews, Cnews and INN traditional
2300                     spool  style),   common   values   are   /var/spool/news,
2301                     /usr/spool/news,  /news/spool.   $TIN_SPOOLDIR  overrides
2302                     any specified value.
2303
2304              overviewdir
2305                     Base of  your  NOV  database  newsoverview(5)  (tradspool
2306                     style;  might be the same dir as spooldir), common values
2307                     are /var/spool/overview, /usr/spool/overview, /news/over‐
2308                     view. $TIN_NOVROOTDIR overrides any specified value.
2309
2310              overviewfile
2311                     Name  of a single overview file, common values are .over‐
2312                     view, over.view. $TIN_NOVFILENAME overrides any specified
2313                     value.
2314
2315              overviewfmtfile
2316                     Full  pathname  of  your  newssystem's overview.fmt file;
2317                     usually the overview.fmt file is in  newslibdir,  so  you
2318                     only  have  to  change this setting if your configuration
2319                     differs.
2320
2321              activefile
2322                     Full pathname of your newssystem's active  file;  usually
2323                     the  active  file  resides  in  newslibdir  and  is named
2324                     active, so you only have to change this setting  if  your
2325                     configuration   differs.  $TIN_ACTIVEFILE  overrides  any
2326                     specified value.
2327
2328              activetimesfile
2329                     Full pathname of  your  newssystem's  active.times  file;
2330                     usually  the active.times file is newslibdir, so you only
2331                     have to change this setting if  your  configuration  dif‐
2332                     fers.
2333
2334              newsgroupsfile
2335                     Full  pathname of your newssystem's newsgroups file; usu‐
2336                     ally the newsgroups file is in newslibdir,  so  you  only
2337                     have  to  change  this setting if your configuration dif‐
2338                     fers.
2339
2340              subscriptionsfile
2341                     Full pathname of your  newssystem's  subscriptions  file;
2342                     usually  the  subscriptions file is in newslibdir, so you
2343                     only have to change this setting  if  your  configuration
2344                     differs.
2345
2346       /usr/local/share/locale/$LC_MESSAGES/LC_MESSAGES/tin.mo
2347
2348              translation  into language specified in $LC_ALL, $LC_MESSAGES or
2349              $LANG
2350
2351       ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
2352
2353              This file lists the newsgroups that  the  local  site  receives.
2354              Each  newsgroup  should be listed only once. Each line specifies
2355              one group; within each newsgroup, articles are  assigned  unique
2356              names, which are monotonically increasing numbers.
2357
2358              If  an  article  is  posted  to newsgroups not mentioned in this
2359              file, those newsgroups are ignored.  If no valid newsgroups  are
2360              specified, the article is rejected.
2361
2362              Each line consists of four space-separated fields "name highmark
2363              lowmark flags".
2364
2365              name   is the name of the newsgroup
2366
2367              highmark
2368                     is the highest article number that has been used in  that
2369                     newsgroup
2370
2371              lowmark
2372                     is the lowest article number in the group; this number is
2373                     not guaranteed to be accurate, and should only  be  taken
2374                     to be a hint. Note that because of article cancellations,
2375                     there may be gaps in the numbering sequence. If the  low‐
2376                     est  article  number  is greater than the highest article
2377                     number, then there are no articles in the newsgroup.
2378
2379              flags  can be one of those
2380
2381                     y      local postings are allowed
2382
2383                     n      no local postings are allowed, only remote ones
2384
2385                     m      the group is moderated and all  postings  must  be
2386                            approved
2387
2388                     j      articles  in  this  group  are  not kept, but only
2389                            passed on
2390
2391                     x      articles cannot be posted to this newsgroup
2392
2393                     =foo.bar
2394                            articles are locally filed  into  the  ''foo.bar''
2395                            group
2396
2397              tin(1) only tries to read the file if you read directly from the
2398                     local spool, if you read news via NNTP, tin(1)  uses  the
2399                     LIST (RFC3977) or LIST COUNTS (RFC6048) command instead.
2400
2401       ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
2402
2403              This file provides a chronological record of when newsgroups are
2404              created. It is normally updated by the local news  server  (e.g.
2405              innd(8))  whenever  a new group is created. Each line consist of
2406              three space-separated fields "name time creator".
2407
2408              name   is the name of the newsgroup
2409
2410              time   is the time when the group was created, expressed as  the
2411                     number of seconds since the Epoch.
2412
2413              creator
2414                     is  the electronic mail address of the person who created
2415                     the group.
2416
2417              tin(1) only tries to read the file if you read directly from the
2418                     local  spool,  if you read news via NNTP, tin(1) uses the
2419                     NEWGROUPS (RFC3977) command instead.
2420
2421       ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
2422
2423              This file provides short descriptions of each newsgroup.  It  is
2424              normally  updated by the local news server (e.g.  innd(8)) when‐
2425              ever a new group is created. Each line consist of two  tab-sepa‐
2426              rated fields "group.name             one-line description".
2427
2428              group.name
2429                     is the name of the newsgroup
2430
2431              one-line description
2432                     is a short single-line description of the group
2433
2434              tin(1) only tries to read the file if you read directly from the
2435                     local spool, if you read news via NNTP, tin(1)  uses  the
2436                     LIST NEWSGROUPS (RFC3977) command instead.
2437
2438       ${TIN_LIBDIR:-NEWSLIBDIR}/organization
2439
2440              This  file  might  hold a default organization to be used in the
2441              ''Organization:'' header. $ORGANIZATION has a higher priority if
2442              set.
2443
2444       ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
2445
2446              This  file specifies the organization of the news overview data‐
2447              base (see also newsoverview(5)).  The order  of  lines  in  this
2448              file  is  important; it determines the order in which the fields
2449              will appear in the database. See also  overview.fmt(5).   tin(1)
2450              only  tries to read the file if you read directly from the local
2451              spool, if you read news via NNTP, tin(1)  uses  the  LIST  OVER‐
2452              VIEW.FMT (RFC3977) command instead.
2453
2454       ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
2455
2456              This  file  contains a list of newsgroups — one per line — which
2457              the client should subscribe to when the user has no  ${TIN_HOME‐
2458              DIR:-"$HOME"}/.newsrc for the news server.  tin(1) only tries to
2459              read the file if you read directly from the local spool, if  you
2460              read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
2461              command instead.
2462

SEE ALSO

2464       elm(1),  inews(1),  ispell(1),  lp(1),  lpr(1),  metamail(1),  perl(1),
2465       perlre(1),  pgp(1),  rn(1),  shar(1),  slrnface(1),  tin(1), xterm(1x),
2466       heapsort(3),   iconv(3),   iconv_open(3),   nl_langinfo(3),    pcre(3),
2467       pcrepattern(3),    qsort(3),    strftime(3),    system(3),   active(5),
2468       mailcap(5),   mbox(5),   mmdf(5),   newsoverview(5),   overview.fmt(5),
2469       innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980,
2470       RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048
2471
2472
2473
24742.4.5                         December 24th, 2020                       tin(5)
Impressum