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



NAME
     folder, folders - set/list current folder/message

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

     The folders command is equivalent to the command  folder
     -all.

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

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

     If a +folder and/or msg are specified, they become the
     current folder and/or message.  A -all switch produces 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)
             /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(1mh).  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 a -all or a -header switch is
     specified; it is suppressed by -noheader.  Also, if folder



Printed 4/6/89                                                  1

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



     is invoked by a name ending with s (e.g., folders), -all is
     assumed.  A -total switch produces only the summary line.

     If -fast is given, only the folder name (or names in the
     case of -all) is 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, the command
     folder -down will set the folder to <current-folder>/select,
     and if the current folder is a selection-list folder, the
     command folder -up will set the current folder to the parent
     of the selection-list.  (See pick(1mh) for details on
     selection-lists).

     The switch -pack causes the messages in the selected folders
     to be renumbered; this eliminates the holes in the sequence
     caused by removing messages.

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

     The folder command 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 than the
                         conventional method because the folders
                         do not have to be read.)

     -header             Prints the folder header line.



Printed 4/6/89                                                  2

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



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

     -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), and
     mh_profile(5mh).
























Printed 4/6/89                                                  3

%%index%%
na:336,101;
sy:437,1259;
de:1696,2598;4702,2198;
op:6900,828;8136,1422;
fi:9558,198;
se:9756,667;
%%index%%000000000131