folder man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

folder(1)							     folder(1)

       folder  -  set  folder  or  display current folder name (only available
       within the message handling system, mh)

       folder [+folder] [msg] [options]

       Displays information on all the folders in your	Mail  directory.   The
       folders are listed alphabetically, with a line of information given for
       each folder. This is identical to the display produced by  the  folders
       command.	 See  folders(1).   Lists only the name of the current folder,
       with no additional information. This is faster because the folders need
       not  be read.  Displays a header produced by the system, in addition to
       the information about the current file. This header is identical to the
       one  that  appears at the top of the listing produced by folder -all or
       by folders.  The header	can  be	 suppressed  by	 using	the  -noheader
       option.	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.	The contents of the folder-stack are listed automatically when
       the -pop or -push option is used. This corresponds to the  dirs	opera‐
       tion  in	 the C-shell.  Re-numbers messages in the folder. 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 cor‐
       responds 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
       each  folder  recursively.  Information	on  the current folder is dis‐
       played, 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 the current
       folder. It can be suppressed using the -nototal option.

       The defaults for folder are:

       +folder	defaults to the current folder
       msg defaults to none

       The folder command lets you set the current folder, or display informa‐
       tion about it.  It can also be used to manage the folder stack.

       If you use the folder command without a +folder	argument,  information
       about  the current folder is displayed on the screen. If you use folder
       with the +folder argument, the named folder is set to  be  the  current
       folder.	Information  about  the	 named folder is also displayed on the

       If you use folder with the msg argument, it will set the specified mes‐
       sage  to	 be  current.  Information  on the current folder is also dis‐
       played. You can use both the +folder and msg arguments together in  one

       If you specify a +folder that does not exist, you are asked whether you
       want to create it. This is a good way to create	an  empty  folder  for
       later use.

       The display is identical whether you set the folder or display the con‐
       tents of the current folder. The following example shows	 the  type  of
       display	that  is  produced.  The display lists the current folder, the
       number of messages in it, the range of the messages (low-high), and the
       current	message	 within	 the folder. It also flags extra files if they
       exist.  inbox+ has   16 messages (   3-	22); cur=  15.

       Do not create folder names that are made up of only digits.

       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

       The following example shows how folder can be used to change  the  cur‐
       rent  folder to +test, and display information on that folder. The plus
       sign (+) next to test indicates that it is now the current  folder.   %
       folder +test
			 test+	has	2 messages (   1-   2); cur=   2.  The
       next example shows the display produced by using	 the  -all  option  to
	 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.

	      This  display  is identical to that produced by the folders com‐
	      mand. See folders(1) for an explanation of  this	display.   The
	      next  example shows how to use folder to create an empty folder:
	      % folder +test Create folder "$HOME/Mail/test"? y
			test+ has no messages.	You can	 also  use  folder  to
	      create  an  empty sub-folder within an existing folder. The fol‐
	      lowing example shows how you can	create	a  sub-folder  in  the
	      folder	+test:	  %   folder   +test/testtwo   Create	folder
	      "$HOME/Mail/test/testwo"? y
				test/testtwo+ has no messages.

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

       The user profile.

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


List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net