   ENVIRONMENT
     The following environment variables are paid attention to by trn.  In
     general the default values assumed for these variables by trn are rea-
     sonable, so if you are using trn for the first time, you can safely
     ignore this section.  Note that the defaults below may not correspond
     precisely to the defaults on your system.  To find the actual defaults
     you would need to look in config.h and common.h in the trn source direc-
     tory, and the file INIT in the trn library directory.

     Those variables marked (%) are subject to % interpolation, and those
     marked (~) are subject to both % interpolation and ~ interpretation.

     ATTRIBUTION (%)
             Gives the format of the attribution line in front of the quoted
             article included by an F command.

             Default: In article %i,%?%)f <%>f> wrote:

     AUTOSUBSCRIBE
             When trn is checking for new newsgroups and finds one matching
             one of the patterns in AUTOSUBSCRIBE, the new group is automati-
             cally added to the end of the .newsrc, subscribed.  Newsgroups
             not matching this or AUTOUNSUBSCRIBE, below, are offered to the
             user.

             AUTOSUBSCRIBE is a comma separated list of newsgroup patterns
             ala 'o', '/', etc.  It can also include "but not" entries pre-
             ceded by '!'.  "a,b,!c,d" is read as "matching a or b, unless it
             also matches c; matching d regardless".  Another way to look at
             it is "(((a or b) and not c) or d)".  To automatically subscribe
             to all local groups but be choosy about non-local groups, one
             might say "*,!*.*".

             Default: (none)

     AUTOUNSUBSCRIBE
             AUTOUNSUBSCRIBE is very similar to AUTOSUBSCRIBE, above, but new
             newsgroups matching it are automatically added to the end of the
             .newsrc file, unsubscribed.  If a newsgroup matches AUTOSUB-
             SCRIBE, AUTOUNSUBSCRIBE is not consulted.

             Default: (none)

     CANCEL (~)
             The shell command used to cancel an article.

             Default: inews -h < %h

     CANCELHEADER (%)
             The format of the file to pass to the CANCEL command in order to
             cancel an article.

             Default:
             Newsgroups: %n
             Subject: cmsg cancel %i
             References: %R
             Reply-To: %L@%H (%N)
             Distribution: %D
             Organization: %o

             %i cancelled from rn.

     DOTDIR  Where to find your dot files, if they aren't in your home direc-
             tory.  Can be interpolated using "%.".

             Default: $HOME

     EDITOR (~)
             The name of your editor, if VISUAL is undefined.

             Default: whatever your news administrator compiled in, usually
             vi.

     EXSAVER (%)
             The shell command to execute in order to extract data to either
             /bin/sh or a user-specified command.

             Default: tail +%Bc %A | %e

     FIRSTLINE (%)
             Controls the format of the line displayed at the top of an arti-
             cle.  Warning: this may go away.

             The default (ignoring the Marked to return display in unthreaded
             groups) is approximately:

             %C #%a%(%Z=^0$?%(%U!=^0$? (%U more\)): (%U + %v more\))

     HIDELINE
             If defined, contains a regular expression which matches article
             lines to be hidden, in order, for instance, to suppress quoted
             material.  A recommended string for this purpose is "^>...",
             which doesn't hide lines with only '>', to give some indication
             that quoted material is being skipped.  If you want to hide more
             than one pattern, you can use "|" to separate the alternatives.
             You can view the hidden lines by restarting the article with the
             'v' command.

             There is some overhead involved in matching each line of the
             article against a regular expression.  You might wish to use a
             baud-rate modifier to enable this feature only at low baud
             rates.

             Default: undefined

     HOME    Your home directory.  Affects ~ interpretation, and the location
             of your dot files if DOTDIR is not defined.

             Default: $LOGDIR

     KILLGLOBAL (~)
             Where to find the KILL file to apply to every newsgroup.  See
             the '^K' command at the newsgroup-selection level.

             Default: %p/KILL

     KILLLOCAL (~)
             Where to find the KILL file for the current newsgroup.  See the
             commands 'K' and '^K' at the article selection level, and the
             search modifier 'K'.

             Default: %p/%c/KILL

     LOGDIR  Your home directory if HOME is undefined.  Affects ~ interpreta-
             tion, and the location of your dot files if DOTDIR is not
             defined.

             Default: none.

             Explanation: you must have either $HOME or $LOGDIR.

     LOGNAME Your login name, if USER is undefined.  May be interpolated
             using "%L".

             Default: value of getlogin().

     LOCALTIMEFMT
             The format used by strftime() to print the local time.  The Date
             line is only displayed in local time if the group is threaded
             (see the -H option for more information on Date).

             Default: %a %b %e %X %Z %Y

             which is the same format as the date(1) command.

     MAILCALL (~)
             What to say when there is new mail.

             Default: (Mail)

     MAILFILE (~)
             Where to check for mail.

             Default: /usr/spool/mail/%L

     MAILHEADER (%)
             The format of the header file for replies.  See also MAILPOSTER.

             Default:

             To: %t
             Subject: %(%i=^$?:Re: %S
             Newsgroups: %n
             In-Reply-To: %i)
             %(%[references]!=^$?References\: %[references]
             )Organization: %o
             Cc:
             Bcc: \n\n

     MAILPOSTER (~)
             The shell command to be used by the reply commands (r and R) in
             order to allow you to enter and deliver the response.  trn will
             not itself call upon an editor for replies -- this is a function
             of the program called by trn.  See also MAILHEADER.

             Default: QUOTECHARS=%I Rnmail -h %h

     MBOXSAVER (~)
             The shell command to save an article in mailbox format.

             Default: %X/mbox.saver %A %P %c %a %B %C "%b" \
             "From %t %`date`"

             Explanation: the first seven arguments are the same as for NORM-
             SAVER.  The eighth argument to the shell script is the new From
             line for the article, including the posting date, derived either
             directly from the Posted: line, or not-so-directly from the
             Date: line.  Header munging at its finest.

     MODSTRING
             The string to insert in the group summary line, which heads each
             article, for a moderated group.  See also NOPOSTRING.

             Default: " (moderated)"

     NAME    Your full name.  May be interpolated using "%N".

             Default: name from /etc/passwd, or ~/.fullname.

     NEWSHEADER (%)
             The format of the header file for follow-ups.  See also
             NEWSPOSTER.

             Default:

             %(%[followup-to]=^$?:X-ORIGINAL-NEWSGROUPS: %n
             )Newsgroups: %(%F=^$?%C:%F)
             Subject: %(%S=^$?%"\n\nSubject: ":Re: %S)
             Summary:
             Expires:
             %(%R=^$?:References: %R
             )Sender:
             Followup-To:
             %(%{REPLYTO}=^$?:Reply-To: %{REPLYTO}
             )Distribution: %(%i=^$?%"Distribution: ":%D)
             Organization: %o
             Keywords: %[keywords]
             Cc: \n\n

     NEWSORG Either the name of your organization, or the name of a file con-
             taining the name of your organization.  (For use at sites where
             the ORGANIZATION environmental variable is already in use.
             NEWSORG will override ORGANIZATION if both are present.) May be
             interpolated using "%o".

             Default: whatever your news administrator compiled in.

     NEWSPOSTER (~)
             The shell command to be used by the follow-up commands (f and F)
             in order to allow you to enter and post a follow-up news arti-
             cle.  trn will not itself call upon an editor for follow-ups --
             this is a function of the program called by trn.  See also NEWS-
             HEADER.

             Default: QUOTECHARS=%I Pnews -h %h

     NEWSRC  Your newsgroup subscription list.

             Default: $HOME/.newsrc

     NNTPSERVER
             The hostname of your NNTPSERVER.  [This does not apply unless
             you are running the NNTP version of rn.]

             Default: the hostname listed in the server file, usually
             /usr/local/lib/rn/server.

     NOPOSTRING
             The string to insert in the group summary line, which heads each
             article, for a group to which local posting is not allowed.  See
             also MODSTRING.

             Default: " (no posting)"

     NORMSAVER (~)
             The shell command to save an article in the normal (non-mailbox)
             format.

             Default: %X/norm.saver %A %P %c %a %B %C "%b"

     ORGANIZATION
             Either the name of your organization, or the name of a file con-
             taining the name of your organization.  (If NEWSORG is set, it
             will override ORGANIZATION.) May be interpolated using "%o".

             Default: whatever your news administrator compiled in.

     PAGESTOP
             If defined, contains a regular expression which matches article
             lines to be treated as form-feeds.  There are at least two
             things you might want to do with this.  To cause page breaks
             between articles in a digest, you might define it as "^--------
             ".  To force a page break before a signature, you could define
             it as "^-- $".  (Then, when you see "--" at the bottom of the
             page, you can skip the signature if you so desire by typing 'n'
             instead of space.) To do both, you could use "^--".  If you want
             to break on more than one pattern, you can use "|" to separate
             the alternatives.

             There is some overhead involved in matching each line of the
             article against a regular expression.  You might wish to use a
             baud-rate modifier to enable this feature only at low baud
             rates.

             Default: undefined

     PIPESAVER (%)
             The shell command to execute in order to accomplish a save to a
             pipe ("s | command" or "w | command").  The command typed by the
             user is substituted in as %b.

             Default: %(%B=^0$?<%A:tail +%Bc %A |) %b

             Explanation: if %B is 0, the command is "<%A %b", otherwise the
             command is "tail +%Bc %A | %b".

     REPLYTO The value of the "Reply-To:" header, if needed.


     RNINIT  This variable is used when initializing trn in rn-compatibility
             mode (see the -x switch) or when the TRNINIT variable isn't
             defined.  See the TRNINIT variable for a description.

     RNMACRO (~)
             The name of the file containing macros and key mappings when
             running trn as rn.  See also the TRNMACRO variable and the
             CUSTOM MACROS section.

             Default: %./.rnmac

     SAVEDIR (~)
             The name of the directory to save to, if the save command does
             not specify a directory name.

             Default:
                If -/ is set: %p/%c
                If +/ is set: %p

     SAVENAME (%)
             The name of the file to save to, if the save command contains
             only a directory name.

             Default:
                If -/ is set: %a
                If +/ is set: %^C

     SELECTCHARS
             The characters used by the thread selector to select the associ-
             ated thread of discussion.  You can specify up to 64 visible
             characters, including upper- and lower-case letters, numbers,
             and many punctuation characters.  Selection characters override
             command characters in the selector, but are not excluded from
             macro expansion, so be careful.
             Default: abdefgijlorstuvwxyz1234567890BCFGHIKMVW
             (You'll notice various characters are omitted to allow them to
             be typed as commands in the selector.)

     SHELL   The name of your preferred shell.  It will be used by the '!',
             'S' and 'W' commands.

             Default: whatever your news administrator compiled in.

     SUBJLINE (%)
             Controls the format of the lines displayed by the '=' command at
             the article selection level.

             Default: %s

     SUPERSEDEHEADER (%)
             The format of the header file for a supersede article.

             Default:

             From: %L@%H (%N)
             Newsgroups: %n
             Subject: %S
             Distribution: %D
             Organization: %o
             Supersedes: %i

     TERM    Determines which termcap entry to use, unless TERMCAP contains
             the entry.

     TERMCAP Holds either the name of your termcap file, or a termcap entry.

             Default: /etc/termcap, normally.

     TRNINIT Default values for switches may be passed to trn by placing them
             in the TRNINIT variable (or RNINIT if you're starting trn in
             rn-compatibility mode).  Any switch that is set in this way may
             be overruled on the command line, or via the '&' command from
             within trn.  Binary-valued switches that are set with "-switch"
             may be unset using "+switch".

             If TRNINIT begins with a '/' it is assumed to be the name of a
             file containing switches.  You can put comments in this file by
             preceding them with a '#' as long as this is the first character
             on a line or it follows some white-space (which delimits the
             switches in the file).  If you want to set many environment
             variables but don't want to keep them all in your environment,
             or if the use of any of these variables conflicts with other
             programs, you can use this feature along with the -E switch to
             set the environment variables upon startup.

             Default: " ".

     TRNMACRO (~)
             The name of the file containing macros and key mappings.  If the
             file is not found, the RNMACRO variable is used to look for your
             rn macros.  For information on what to put into this file, see
             the CUSTOM MACROS section.

             Default: %./.trnmac

     UNSHAR (~)
             The shell command to execute in order to accomplish the
             unshar'ing of a shell archive.

             Default: /bin/sh

     USER    Your login name.  May be interpolated using "%L".

             Default: $LOGNAME

     VISUAL (~)
             The name of your editor.

             Default: $EDITOR

     YOUSAID (%)
             Gives the format of the attribution line in front of the quoted
             article included by an R command.

             Default: In article %i you write:
