folders(1)						      General Commands Manual							folders(1)

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  mes-
       sages  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 recur-
       sively. 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 sup-
       pressed 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 exam-
       ple:

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

																	folders(1)