Document new fmttest program.

[nmh] / man / mh-profile.man

diff --git a/man/mh-profile.man b/man/mh-profile.man
index 6395dd69b5829412185063e9a3192cb3f1dcc36c..d7afe5be2fc72710c8084f4de8078dd54f446f91 100644 (file)
--- a/man/mh-profile.man
+++ b/man/mh-profile.man
@@ -1,4 +1,4 @@
-.TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-PROFILE %manext5% "November 6, 2012" "%nmhversion%"

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


@@ -31,6 +31,9 @@ This is a comment.
 .PP
 Blank lines are not permitted in
 .IR \&.mh\(ruprofile.
 .PP
 Blank lines are not permitted in
 .IR \&.mh\(ruprofile.

+The shell quoting conventions are not available in the
+.IR \&.mh\(ruprofile ;
+each token is separated by whitespace.

 .SS "Standard Profile Entries"
 The possible profile components are exemplified below.  The only mandatory
 entry is `Path:'.  The others are optional; some have default values if
 .SS "Standard Profile Entries"
 The possible profile components are exemplified below.  The only mandatory
 entry is `Path:'.  The others are optional; some have default values if


@@ -142,7 +145,7 @@ man page for details about private sequences.
 .RE
 .PP
 .BR Editor :
 .RE
 .PP
 .BR Editor :

-/usr/bin/vi
+vi

 .RS 5
 Defines the editor to be used by the commands
 .BR comp ,
 .RS 5
 Defines the editor to be used by the commands
 .BR comp ,


@@ -150,7 +153,9 @@ Defines the editor to be used by the commands
 .BR forw ,
 and
 .BR repl .
 .BR forw ,
 and
 .BR repl .

-(profile, default: %default_editor%)
+If not set in profile the value will be taken from the VISUAL and
+EDITOR environment variables.
+(profile, default: vi)

 .RE
 .PP
 .BR automimeproc :
 .RE
 .PP
 .BR automimeproc :


@@ -356,6 +361,13 @@ The
 .I \&.mh\(ruprofile
 can be used to select alternate programs if the
 user wishes.  The default values are given in the examples.
 .I \&.mh\(ruprofile
 can be used to select alternate programs if the
 user wishes.  The default values are given in the examples.

+.PP
+If the profile element contains spaces, the element is split at spaces
+into tokens and each token is given as a seperate argument to the
+.IR execvp (2)
+system call.  If the element contains shell metacharacters then the entire
+element is executed using
+.BR /bin/sh .

 .RE
 .PP
 .BR buildmimeproc :
 .RE
 .PP
 .BR buildmimeproc :


@@ -405,16 +417,8 @@ to incorporate new mail when it
 is invoked with no arguments.
 .RE
 .PP
 is invoked with no arguments.
 .RE
 .PP

-.BR installproc :
-%libdir%/install\-mh
-.RS 5
-This program is called to initialize the environment for
-new users of
-.BR nmh .
-.RE
-.PP

 .BR lproc :
 .BR lproc :

-%default_pager%
+more

 .RS 5
 This program is used to list the contents of a message in response
 to the
 .RS 5
 This program is used to list the contents of a message in response
 to the


@@ -479,7 +483,7 @@ that is sent to \*(lqBcc:\*(rq recipients.
 .RE
 .PP
 .BR moreproc :
 .RE
 .PP
 .BR moreproc :

-%default_pager%
+more

 .RS 5
 This is the program used by
 .B mhl
 .RS 5
 This is the program used by
 .B mhl


@@ -846,9 +850,13 @@ and
 .B repl
 during edit sessions so you can
 peruse the message being distributed or replied to.  The message is also
 .B repl
 during edit sessions so you can
 peruse the message being distributed or replied to.  The message is also

-available through a link called \*(lq@\*(rq in the current directory if
+available, when the
+.B \-atfile
+switch is used,
+through a link called \*(lq@\*(rq in the current directory if

 your current working directory and the folder the message lives in are
 your current working directory and the folder the message lives in are

-on the same UNIX filesystem.
+on the same UNIX filesystem, and if your current working directory is
+writable.

 .RE
 .PP
 .B $mhdraft
 .RE
 .PP
 .B $mhdraft


@@ -1004,10 +1012,6 @@ lower-case).  If the entry is not absolute (does not start with a
 directory.  As a result, you can actually have more than one set of
 private sequences by using different context files.
 .SH BUGS
 directory.  As a result, you can actually have more than one set of
 private sequences by using different context files.
 .SH BUGS

-The shell quoting conventions are not available in the
-.IR \&.mh\(ruprofile .
-Each token is separated by whitespace.
-.PP

 There is some question as to what kind of arguments should be placed
 in the profile as options.  In order to provide a clear answer, recall
 command line semantics of all
 There is some question as to what kind of arguments should be placed
 in the profile as options.  In order to provide a clear answer, recall
 command line semantics of all