folder man page on Ultrix

Printed from http://www.polarhome.com/service/man/?qf=folder&af=0&tf=2&of=Ultrix

folder(1mh)							   folder(1mh)

Name
       folder - set folder or display current folder name

Syntax
       folder [ +folder ] [ msg ] [ options ]

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

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

       If  you use with the msg argument, it will set the specified message to
       be current.  Information on the current folder is also displayed.   You
       can use both the +folder and msg arguments together in one command.

       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.

Options
       -all	 Displays information on all the folders in your  Mail	direc‐
		 tory.	 The folders are listed alphabetically, with a line of
		 information given for each folder.  This is identical to  the
		 display produced by the command.  See

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

       -header
       -noheader 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
		 or by The header can be suppressed  by	 using	the  -noheader
		 option.

       -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.  The  contents  of  the  folder-
		 stack	are listed automatically when the -pop or -push option
		 is used.  This corresponds to the operation in the C-shell.

       -pack
       -nopack	 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  num‐
		 bering in the folder.

       -pop	 Discards  the top of the folder-stack, after setting the cur‐
		 rent folder to that value.  No +folder	 argument  is  allowed
		 with  this  option.  This corresponds to the operation in the
		 C-shell; see The -push and -pop options are  mutually	exclu‐
		 sive:	the last occurrence of either one overrides any previ‐
		 ous 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 operation in the C-
		 shell; see 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 each folder recursively.	 Information  on  the  current
		 folder is displayed, followed by information on any sub-fold‐
		 ers which it contains.

       -total
       -nototal	 Displays only the total number of  messages  and  folders  in
		 your Mail directory.  This option does not print any informa‐
		 tion about the current folder.	 It can	 be  suppressed	 using
		 the -nototal option.

       The defaults for are:

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

Examples
       The  following  example	shows  how  can	 be used to change the current
       folder to and display information on that folder.  The  plus  sign  (+)
       next to 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 command.  See for an
       explanation of this display.

       The next example shows how to use to create an empty folder:
       % folder +test
       Create folder "$HOME/Mail/test"? y
		 test+ has no messages.

       You can also use to create  an  empty  sub-folder  within  an  existing
       folder.	The following example shows how you can create a sub-folder in
       the folder
       % folder +test/testtwo
       Create folder "$HOME/Mail/test/testwo"? y
		 test/testtwo+ has no messages.
       See for more details of sub-folders.

Files
       The user profile.

Profile Components
       Path:		 To determine your MH directory
       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

See Also
       csh(1), refile(1mh), mhpath(1mh)

								   folder(1mh)
[top]

List of man pages available for Ultrix

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]
Tweet
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