Content-type: text/html Man page of folders

folders

Section: User Commands (1)
Index Return to Main Contents
 

NAME

folders - list folders and contents (only available within the message handling system, mh)  

SYNOPSIS

folders [+folder] [msg] [options]


 

OPTIONS

Lists only the name of folders, with no additional information. This is faster because the folders need not be read. Prints a list of the valid options to this command. Lists the contents of the folder-stack. No +folder argument is allowed with this option. Re-numbers messages in the folders. Messages are re-numbered sequentially, and any gaps in the numbering are removed. The default operation is -nopack, which does not change the numbering in the folder. Discards the top of the folder-stack, after setting the current folder to that value. No +folder argument is allowed with this option. This corresponds to the popd operation in the C-shell; see csh(1). The -push and -pop options are mutually exclusive: the last occurrence of either one overrides any previous occurrence of the other. Pushes the current folder onto the folder-stack, and makes the +folder argument into 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 C-shell; see csh(1). The -push switch and the -pop switch are mutually exclusive: the last occurrence of either one overrides any previous occurrence of the other. Lists folders recursively. Information on each folder is displayed, followed by information on any sub-folders which it contains. Displays only the total number of messages and folders in your Mail directory. This option does not print any information about individual folders. It can be suppressed using the -nototal option.

The defaults for folders are:

+folder defaults to all msg defaults to none -nofast -noheader -nototal -nopack -norecurse


 

DESCRIPTION

The folders command displays the names of your folders and the number of messages that they each contain.

The folders command displays a list of all the folders in your Mail directory. The folders are sorted alphabetically, each on its own line. 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 be either sub-folders, or files that do not belong under the MH file naming scheme.

The folders command is identical to the effect of using the -all option to the folder command.

If you use folders with the +folder argument, it will display all the subfolders within the named folder. as shown in the following example:

% 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.

See refile(1) for more details of sub-folders.
 

RESTRICTIONS

MH does not allow you to have more than 100 folders at any level in your Mail directory.
 

PROFILE COMPONENTS

Path: To determine your MH directory

Folder-Protect: To set protections when creating a new folder

Folder-Stack: To determine the folder stack

lsproc: Program to list the contents of a folder
 

FILES

The user profile.
 

SEE ALSO

csh(1), folder(1), refile(1), mhpath(1)


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
RESTRICTIONS
PROFILE COMPONENTS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:51 GMT, October 02, 2010