folders(1mh)
Name
folders − list folders and contents
Syntax
folders [folder] [msg] [−fast] [−nofast] [−header] [−noheader] [−pack] [−nopack] [−recurse] [−norecurse] [−total] [−nototal] [−print] [−noprint] [−list] [−nolist] [−push] [−pop] [−help]
Description
The folders command lets you display the names of your folders and the number of messages that they each contain.
When you use folders, the display contains a line for each folder in your MH directory, sorted alphabetically. This is illustrated in the following example.
Folder # of messages (range); cur msg (other files)
V2.3 has 3 messages (1-3).
adrian has 20 messages (1-20); cur= 2.
brian has 16 messages (1-16).
chris has 12 messages (1-12).
copylog has 242 messages (1- 242); cur= 225.
inbox+ has 73 messages (1- 127); cur= 127.
int has 4 messages (1-4); cur= 2 (others).
jack has 17 messages (1-17); cur= 17.
TOTAL= 387 messages in 8 folders.
The plus sign (+) after inbox indicates that it is the current folder. The information about the int folder includes the term (others). This indicates that the folder int contains files which are not messages. These files may either be sub-folders, or files that do not belong under the MH file naming scheme.
In all respects, the effect of using folders is identical to the effect of using folder −all. See folder() for details.
If you use folders with the +foldername argument, folders will display all the subfolders within the nominated folder, as shown in the following example. See refile() for more details of sub folders.
% folders +test
Folder # of messages ( range ); cur msg (other files)
test+ has 18 messages ( 1- 18); (others).
test/testone has 1 message ( 1- 1).
test/testtwo has no messages.
TOTAL= 19 messages in 3 folders.
If you specify a folder, that folder will become the current folder.
The remainder of the options work as they do for folder−all. See folder() for details.
The defaults for folders are:
+foldername defaults to all
msg defaults to none
−nofast
−noheader
−nototal
−nopack
−norecurse
Restrictions
You cannot have more than 100 folders in any one level.
Files
| $HOME/.mh_profile | The user profile |
Profile Components
| Path: | To determine your 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 |