.TH folders 1mh.SH Namefolders \- list folders and contents .SH Syntax.B folders[.I +folder] [.I msg] [ .I options].\".\".\".\".SH Description.NXR "folders command".NXR "displaying folders"The .PN folderscommand displays the names of your folders and the number of messages that they each contain..PPThe .PN folderscommand 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:.EX  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..EEThe plus sign (+) after inbox indicates that it is the current folder.The information about the .PN int folder includes the term \f(CW(others)\fR.This indicates that the folder .PN intcontains files which are not messages.These files may be either sub-folders,or files that do not belong under the MH file naming scheme..PPThe .PN folders command is identical to the effect of using the.B \-alloption to the .PN foldercommand..PPIf you use .PN folderswith the .I +folderargument, it will display all the subfolders within the named folder.as shown in the following example:.EX% folders +testFolder           # 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..EESee.MS refile 1mhfor more details of sub-folders..\".\".\".\".SH Options.IP "\-fast" 10.PD 0.IP "\-nofast".PDLists only the name of folders,with no additional information.This is faster because the folders need not be read..\".\" *** -header commented out.\" *** no information on this at the moment.ig.IP "\-header" 10.PD 0.IP \"-noheader" 10.PD...\".IP "\-help" 10Prints a list of the valid options to this command..\".IP "\-list" 10.PD 0.IP "\-nolist" 10.PDLists the contents of the folder-stack.No.I +folderargument is allowed with this option..\".IP "\-pack" 10.PD 0.IP "\-nopack".PD Re-numbers messages in the folders.Messages are re-numbered sequentially,and any gaps in the numbering are removed.The default operation is\fB\-nopack\fR,which does not change the numbering in the folder..\".IP "\-pop" 10Discards the top of the folder-stack,after setting the current folder to that value.No.I +folderargument is allowed with this option.This corresponds to the.PN popdoperation in the C-shell; see.MS csh 1 .The.B \-pushand.B \-popoptions are mutually exclusive:the last occurrence of either one overridesany previous occurrence of the other..\".\" *** -print option commented out.\" *** no information on it at this time.ig.IP "\-print" 10.PD 0.IP "\-noprint" 10.PD...\".IP "\-push" 10Pushes the current folder onto the folder-stack,and makes the.I +folderargument into the current folder.If.I +folderis not given, the current folderand the top of the folder-stack are exchanged.This corresponds to the.PN pushdoperation in the C-shell; see.MS csh 1 .The.B \-pushswitch and the.B \-popswitch are mutually exclusive:the last occurrence of either one overrides any previous occurrence of theother..\".IP "\-recurse" 10.PD 0.IP "\-norecurse" 10.PDLists folders recursively.Information on each folder is displayed,followed by information on any sub-folders which it contains..\".IP "\-total" 10.PD 0.IP "\-nototal" 10.PDDisplays only the total number of messages and foldersin your Mail directory.This option does not print any information about individual folders.It can be suppressed using the.B \-nototaloption..\".\".\".PPThe defaults for.PN foldersare:.IP.I +folderdefaults to all.br.I msgdefaults to none.br.B \-nofast.br.B \-noheader.br.B \-nototal.br.B \-nopack.br.B \-norecurse.\".\".\".\".SH RestrictionsMH does not allow you to have more than 100 folders at any levelin your Mail directory..\".\".\".\".SH Profile Components.TStab(+);l l.Path:+To determine your MH directoryFolder-Protect:+To set protections when creating a new folderFolder-Stack:+To determine the folder stacklsproc:+Program to list the contents of a folder.TE.\".\".\".\".SH Files.TP 10.PN $HOME/\&.mh_profileThe user profile..\".\".\".\".SH See Alsocsh(1), folder(1mh), refile(1mh), mhpath(1mh)