folder, folders − set/list current folder/message folder [+folder] [msg] [−all] [−fast] [−nofast] [−header] [−noheader] [−pack] [−nopack] [−recurse] [−norecurse] [−total] [−nototal] [−print] [−noprint] [−list] [−nolist] [−push] [−pop] [−help]
folders
DESCRIPTION
Since the MH environment is the shell, it is easy to lose track of the current folder from day to day. When folder is given the ‘−print’ switch (the default), the current folder and/or message may be set, or all folders may be listed. When a ‘+folder’ argument is given, this corresponds to a “cd” operation in the CShell; when no ‘+folder’ argument is given, this corresponds roughly to a “pwd” operation in the CShell.
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 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. Specifying ‘−all’ 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 “atr−cur−” entries in the user’s MH context. For example,
Folder # of messages( range )cur msg (other files)
/fsd/rs/m/tacchas 35 messages( 1− 35);cur= 23.
/rnd/phyl/Mail/EPhas 82 messages( 1−108);cur= 82.
ffhas no messages.
inbox+has 16 messages( 3− 22);cur= 5.
mhhas 76 messages( 1− 76);cur= 70.
noteshas 2 messages( 1− 2);cur= 1.
ucomhas 124 messages( 1−124);cur= 6; (others).
TOTAL=339 messages in 7 folders
The “+” after inbox indicates that it is the current folder. The “(others)” indicates that the folder ‘ucom’ has files which aren’t messages. These files may either be sub−folders, or files 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 a ‘+folder’ and/or ‘msg’ is given along with the ‘−all’ switch, folder will, in addition to setting the current folder and/or message, list the top−level folders for the current folder (with ‘−norecurse’) or list all folders under the current folder recursively (with ‘−recurse’).
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 ‘−pack’ switch will compress the message names in a folder, removing holes in message numbering.
The ‘−recurse’ switch will list each folder recursively. Use of this option effectively defeats the speed enhancement of the ‘−fast’ option, since each folder must be searched for subfolders. Nevertheless, the combination of these options is useful.
If the specified (or default) folder doesn’t exist, the user will be queried if the folder should be created. (This is the easy way to create an empty folder for use later.)
The ‘−push’ switch directs folder to push the current folder onto the folder−stack, and make the ‘+folder’ argument the current folder. If ‘+folder’ is not given, the current folder and the top of the folder−stack are exchanged. This corresponds to the “pushd” operation in the CShell.
The ‘−pop’ switch directs folder to discard the top of the folder−stack, after setting the current folder to that value. No ‘+folder’ argument is allowed. This corresponds to the “popd” operation in the CShell. The ‘−push’ switch and the ‘−pop’ switch are mutually exclusive: the last occurrence of either one overrides any previous occurrence of the other.
The ‘−list’ switch directs folder to list the contents of the folder−stack. No ‘+folder’ argument is allowed. After a successful ‘−push’ or ‘−pop’, the ‘−list’ action is taken. This corresponds to the “dirs” operation in the CShell. ^$HOME/.mh_profile~^The user profile ^Path:~^To determine the user’s MH directory ^Current−Folder:~^To find the default current folder ^Folder−Protect:~^To set mode when creating a new folder ^Folder−Stack:~^To determine the folder stack ^lsproc:~^Program to list the contents of a folder refile(1), mhpath(1) ‘+folder’ defaults to the current folder ‘msg’ defaults to none ‘−nofast’ ‘−noheader’ ‘−nototal’ ‘−nopack’ ‘−norecurse’ ‘−print’ is the default if no ‘−list’, ‘−push’, or ‘−pop’ is specified If ‘+folder’ and/or ‘msg’ are given, they will become the current folder and/or message. In previous versions of MH, the ‘−fast’ switch prevented context changes from occurring for the current folder. This is no longer the case: if ‘+folder’ is given, then folder will always change the current folder to that.
NEWS-OSRelease 3.3