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, and
     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 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)
             /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 5/12/88                                                 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, 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(1MH) 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.

     If +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 5/12/88                                                 2

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



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























Printed 5/12/88                                                 3

%%index%%
na:336,101;
sy:437,1259;
de:1696,2614;4718,2915;
op:7633,1129;9170,1590;
fi:10760,201;
se:10961,666;
%%index%%000000000134