unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



folders(1)							   folders(1)



NAME

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

SYNOPSIS

  folders [+folder] [msg] [options]

OPTIONS

  -fast

  -nofast
      Lists only the name of folders, with no additional information.  This
      is faster	because	the folders need not be	read.

  -help
      Prints a list of the valid options to this command.

  -list

  -nolist
      Lists the	contents of the	folder-stack. No +folder argument is allowed
      with this	option.

  -pack

  -nopack
      Re-numbers messages in the folders. Messages are re-numbered sequen-
      tially, and any gaps in the numbering are	removed. The default opera-
      tion is -nopack, which does not change the numbering in the folder.

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

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

  -recurse

  -norecurse
      Lists folders recursively. Information on	each folder is displayed,
      followed by information on any sub-folders which it contains.

  -total

  -nototal
      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 direc-
  tory.	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	sub-
  folders 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

  $HOME/.mh_profile
      The user profile.

SEE ALSO

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