FOLDER(1MH)             COMMAND REFERENCE             FOLDER(1MH)



NAME
     folder - set/list current folder/message

SYNOPSIS
     folder [+folder] [msg] [-pack] [-nopack] [-all] [-fast]
          [-nofast] [-up] [-down] [-header] [-noheader] [-total]
          [-nototal] [-help]

     folders <equivalent to 'folder -all'>

DESCRIPTION
     Since the MH environment is the shell, it is easy to lose
     track of the current folder from day to day.  Folder will
     list the current folder, the number of messages in it, the
     range of the messages (low-high), and the current message
     within the folder, and will flag a selection list or extra
     files if they exist.  An example of the output is:

          inbox+ has 16 messages ( 3- 22); cur= 5.

     If a +folder and/or msg are specified, they will become the
     current folder and/or message.  An -all switch will produce
     a line for each folder in the user's MH directory, sorted
     alphabetically.  These folders are preceded by the read-only
     folders, which occur as mh_profile 'cur-' entries.  For
     example,

     Folder # of messages ( range ); cur msg (other files)
     Folder # of messages ( range ); cur msg (other files)
     /fsd/rs/m/tacc has 35 messages ( 1- 35); cur= 23.
     /rnd/phyl/Mail/EP has 82 messages ( 1-108); cur= 82.
     notes has 2 messages ( 1- 2); cur= 1.
     inbox+ has 16 messages ( 3- 22); cur= 5.
     ff has 4 messages ( 1- 4); cur= 1.
     mh has 76 messages ( 1- 76); cur= 70.
     misc has 1 message ( 1- 1).
     junk has no messages.
     ucom has 124 messages ( 1-124); cur= 6; (select).

     TOTAL = 340 messages in 9 Folders

     The '+' after inbox indicates that it is the current folder.
     The '(select)' indicates that the folder ucom has a
     selection list produced by pick.  If 'others' had appeared
     in parentheses at the right of a line, it would indicate
     that there are files in the folder directory that don't
     belong under the MH file naming scheme.

     The header is output if either an -all or a -header switch
     is specified; it is suppressed by -noheader, Also, if folder
     is invoked by a name ending with 's' (e.g., folders), -all
     is assumed.  A -total switch will produce only the summary



Printed 10/17/86                                                1

FOLDER(1MH)             COMMAND REFERENCE             FOLDER(1MH)



     line.

     If -fast is given, only the folder name (or names in the
     case of -all) will be listed (This is faster because the
     folders need not be read).

     The switches -up and -down change the folder to be the one
     above or below the current folder.  That is, folder-down
     will set the folder to <current-folder>/select, and if the
     current folder is a selection-list folder, folder-up will
     set the current folder to the parent of the selection-list
     (See pick for details on selection-lists).

     The switch -pack causes the messages in the selected
     folder(s) to be renumbered.  This eliminates the holes in
     the sequence caused by removing messages.  It does not
     change the current message number or any of the deleted
     messages (comma filessee rmm).

     If +folder and/or msg are given, they will become the
     current folder and/or message.

     folder has the following defaults:


     +folder                  defaults to the current folder

     msg                      defaults to none

     -nofast

     -noheader

     -nototal

     Your .mh_profile can contain the following entries:

     Path: To determine the user's MH directory
     Current-Folder: To find the default current folder

OPTIONS
     -all
         Produces a list of all the folders in the MH directory,
         sorted alphabetically.

     -down
         Changes the current folder to the one next in the folder
         list.

     -fast
         Prints only the names of the folder or folders. (This is
         faster because the folders do not have to be read.)



Printed 10/17/86                                                2

FOLDER(1MH)             COMMAND REFERENCE             FOLDER(1MH)



     -header
         Prints the folder header line.

     -help
         Prints a list of the possible switches for folder.

     -nofast
         Suppresses the fast function.

     -noheader
         Suppresses the header function.

     -nopack
         Suppresses the pack function.

     -nototal
         Suppresses the total function.

     -pack
         Renumbers the messages in a folder, eliminating holes in
         the numbering sequence.

     -total
         Prints the summary line only.

     -up Changes the current folder to the previous one in the
         folder list.

FILES
     $HOME/.mh_profile        The user profile

     /bin/ls                  To fast-list the folders

SEE ALSO
     comp(1mh), fmt(1mh), folder(1mh), forw(1mh), inc(1mh),
     mail(1mh), mh(1mh), mhl(1mh), next(1mh), pick(1mh),
     prev(1mh), prompter(1mh), refile(1mh), repl(1mh), rmf(1mh),
     rmm(1mh), scan(1mh), send(1mh), show(1mh), mh(5mh),
     mh_profile(5mh).
















Printed 10/17/86                                                3

%%index%%
na:72,76;
sy:148,827;
de:975,3950;5069,1680;
op:6749,473;7366,1085;
fi:8451,178;
se:8629,627;
%%index%%000000000127