NAME

folder − set/list current folder/message

SYNOPSIS

folder [ +folder ] [ msg ] [ −all ] [ −fast ] [ −nofast ] [ −up ] [ −down ] [ −header ] [ −noheader ] [ −total ] [ −nototal ] [ −pack ] [ −nopack ] [ −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)
~/fsd/rs/m/tacc  has~35 messages(~1− 35); cur= 23.
~/rnd/phyl/Mail/EP  has~82 messages(~1−108); cur= 82.
~ff  has~4 messages(~1−  4); cur=  1.
~inbox+ has~16 messages(~3− 22); cur=  5.
~mh  has~76 messages(~1− 76); cur= 70.
~notes  has~2 messages(~1−  2); cur=  1.
~ucom  has~124 messages(~1−124); cur=  6; (select).
 ~TOTAL= 339 messages in  7 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 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 ‘−pack’ switch will compress the message names in a folder, removing holes in message numbering. 

FILES

$HOME/mh_profileThe user profile
/bin/lsTo fast-list the folders

PROFILE COMPONENTS

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

DEFAULTS

‘+folder’ defaults to the current folder
‘msg’ defaults to none
‘−nofast’
‘−noheader’
‘−nototal’
‘−nopack’

CONTEXT

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

4th Berkeley Distribution  —  3 August 1983