Removed send and post -eai switches. Instead, post now enables

[nmh] / man / folder.man

diff --git a/man/folder.man b/man/folder.man
index c2b9ff66fa72c744bea9c2ba100b8a1f0660ce33..92a2cf0083a64a93d2d49e69b6b16aa8cbb7f304 100644 (file)
--- a/man/folder.man
+++ b/man/folder.man
@@ -1,15 +1,15 @@
+.TH FOLDER %manext1% "August 29, 2016" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .\"

-.TH FOLDER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]

 .SH NAME
 folder, folders \- set/list current folder/message
 .SH SYNOPSIS
 .HP 5
 .SH NAME
 folder, folders \- set/list current folder/message
 .SH SYNOPSIS
 .HP 5

+.na

 .B folder
 .RI [ +folder ]
 .B folder
 .RI [ +folder ]

-.RI [ msgs ]
+.RI [ msg ]

 .RB [ \-all " | " \-noall ]
 .RB [ \-create " | " \-nocreate ]
 .RB [ \-fast " | " \-nofast ]
 .RB [ \-all " | " \-noall ]
 .RB [ \-create " | " \-nocreate ]
 .RB [ \-fast " | " \-nofast ]


@@ -24,11 +24,12 @@ folder, folders \- set/list current folder/message
 .RB [ \-version ]
 .RB [ \-help ]
 .PP
 .RB [ \-version ]
 .RB [ \-help ]
 .PP

-.HP
+.HP 5

 .B folders
 is equivalent to
 .B folder
 .B \-all
 .B folders
 is equivalent to
 .B folder
 .B \-all

+.ad

 .SH DESCRIPTION
 Since the
 .B nmh
 .SH DESCRIPTION
 Since the
 .B nmh


@@ -79,16 +80,14 @@ use later.)  Specifying
 .B \-nocreate
 will cause
 .B folder
 .B \-nocreate
 will cause
 .B folder

-to exit
+to print an error message and exit

 without creating a non-existant folder.
 .\"
 .\" note - this doesn't work at present
 .\" If `\-noprint' is specified, 
 .\" a `+folder' and/or `msg' may still be specified
 .\" to set the current folder and/or message,
 without creating a non-existant folder.
 .\"
 .\" note - this doesn't work at present
 .\" If `\-noprint' is specified, 
 .\" a `+folder' and/or `msg' may still be specified
 .\" to set the current folder and/or message,

-.\" but the folder summary will not be printed.
-
-.SS "Multiple Folders"
+.\" but the folder summary will not be printed..SS "Multiple Folders"

 Specifying
 .B \-all
 will produce a summary line for each top-level folder
 Specifying
 .B \-all
 will produce a summary line for each top-level folder


@@ -121,12 +120,13 @@ mh        has \076 messages       (15\-\076);     cur=70.
 notes  has \0\02 messages      (\01\-\0\02);   cur=\01.
 ucom   has 124 messages        (\01\-124);     cur=\06; (others).
 .ta \w'/rnd/phyl/Mail/EP has 'u
 notes  has \0\02 messages      (\01\-\0\02);   cur=\01.
 ucom   has 124 messages        (\01\-124);     cur=\06; (others).
 .ta \w'/rnd/phyl/Mail/EP has 'u

-

 TOTAL = 339 messages in 7 folders
 .fi
 .RE
 .PP
 TOTAL = 339 messages in 7 folders
 .fi
 .RE
 .PP

-The \*(lq+\*(rq after inbox indicates that it is the current folder.
+The \*(lq+\*(rq after
+.I inbox
+indicates that it is the current folder.

 The \*(lq(others)\*(rq indicates that the folder
 .I ucom
 has files which
 The \*(lq(others)\*(rq indicates that the folder
 .I ucom
 has files which


@@ -165,10 +165,17 @@ for the current folder (with
 .BR \-norecurse )
 or list all sub-folders under the current folder recursively (with
 .BR \-recurse ).
 .BR \-norecurse )
 or list all sub-folders under the current folder recursively (with
 .BR \-recurse ).

-In this case, if a
+.PP
+If

 .I msg
 .I msg

-is also supplied, it will become the current message of
-.IR +folder .
+is supplied, together with
+.IR +folder
+or without
+.BR \-all ,
+it will become the current message of
+.IR +folder
+(if it had been supplied)
+or the current folder.

 .PP
 The
 .B \-recurse
 .PP
 The
 .B \-recurse


@@ -253,47 +260,72 @@ and
 .B \-list
 switches turn off
 .BR \-print .
 .B \-list
 switches turn off
 .BR \-print .

-

 .SH FILES
 .SH FILES

-.fc ^ ~
-.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-
+.TP 20
+$HOME/.mh_profile
+The user's profile.

 .SH "PROFILE COMPONENTS"
 .SH "PROFILE COMPONENTS"

-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh 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
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP
+Current\-Folder:
+To find the default current folder.
+.TP
+Folder\-Protect:
+To set mode when creating a new folder.
+.TP
+Folder\-Stack:
+To determine the folder stack.

 .\" ^lsproc:~^Program to list the contents of a folder
 .\" ^lsproc:~^Program to list the contents of a folder

-
+.PD

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-refile(1), mhpath(1)
-
-.SH "DEFAULTS"
-.nf
-.RB ` +folder "' defaults to the current folder"
-.RB ` msg "' defaults to none"
-.RB ` \-nofast '
-.RB ` \-noheader '
-.RB ` \-nototal '
-.RB ` \-nopack '
-.RB ` \-norecurse '
-.RB ` \-noverbose '
-.RB ` \-print "' is the default if no " \-list ", " \-push ", or " \-pop " is specified"
-.RB ` \-list "' is the default if " \-push ", or " \-pop " is specified"
-
+.IR mhpath (1),
+.IR refile (1),
+.IR rmf (1)
+.SH DEFAULTS
+.PD 0
+.TP 20
++folder
+The current folder.
+.TP
+msg
+\*(lqnone\*(rq
+.TP
+\-nofast
+.TP
+\-noheader
+.TP
+\-nototal
+.TP
+\-nopack
+.TP
+\-norecurse
+.TP
+\-noverbose
+.TP
+\-print
+is the default if no
+.BR -list ,
+.BR \-push ,
+or
+.B \-pop
+is specified.
+.TP
+\-list
+is the default if
+.BR \-push ,
+or
+.B \-pop
+is specified.
+.PD

 .SH CONTEXT
 If
 .I +folder
 and/or
 .I msg
 are given, they will become the current folder and/or message.
 .SH CONTEXT
 If
 .I +folder
 and/or
 .I msg
 are given, they will become the current folder and/or message.

-

 .SH BUGS
 There is no way to restore the default behavior 
 (to ask the user whether to create a non-existant folder)
 .SH BUGS
 There is no way to restore the default behavior 
 (to ask the user whether to create a non-existant folder)