X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmh-profile.man;h=a586eefb8d08f8301ef1fd58692d327ec04eab96;hb=5e5e8b753acc7ff1e16c7fca172a2151a6c01353;hp=949cf972528af6bfad8a0dc4a4c15b4d66fd0252;hpb=448dd2a7475f0009820f874e8da381cfaee4a679;p=mmh diff --git a/man/mh-profile.man b/man/mh-profile.man index 949cf97..a586eef 100644 --- a/man/mh-profile.man +++ b/man/mh-profile.man @@ -1,7 +1,7 @@ +.TH MH-PROFILE %manext5% "November 6, 2012" "%nmhversion%" .\" .\" %nmhwarning% .\" -.TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME mh-profile \- user profile customization for nmh message handler .SH SYNOPSIS @@ -31,7 +31,9 @@ This is a comment. .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 @@ -90,7 +92,7 @@ command. If not present or empty, no such sequences are defined. Otherwise, for each name given, the sequence is first zero'd and then each message is added to the sequence. Read the -.BR mh\-sequence (5) +.IR mh\-sequence (5) man page for the details about this sequence. (profile, no default) .RE .PP @@ -100,7 +102,7 @@ not Defines the string which, when prefixed to a sequence name, negates that sequence. Hence, \*(lqnotseen\*(rq means all those messages that are not a member of the sequence \*(lqseen\*(rq. Read the -.BR mh\-sequence (5) +.IR mh\-sequence (5) man page for the details. (profile, no default) .RE .PP @@ -118,7 +120,7 @@ will add or remove messages from these sequences when they are incorporated or read. If not present or empty, no such sequences are defined. Otherwise, each message is added to, or removed from, each sequence name given. Read the -.BR mh\-sequence (5) +.IR mh\-sequence (5) man page for the details about this sequence. (profile, no default) .RE @@ -137,7 +139,7 @@ entry blank. (profile, default: \&.mh\(rusequences) Keeps track of the private sequence called \*(lqseq\*(rq in the specified folder. Private sequences are generally used for read\-only folders. See the -.BR mh\-sequence (5) +.IR mh\-sequence (5) man page for details about private sequences. (context, no default) .RE @@ -169,7 +171,7 @@ composition draft before it is sent. .RS 5 An octal number which defines the permission bits for new message files. See -.BR chmod (1) +.IR chmod (1) for an explanation of the octal number. Note that some filesystems, such as FAT32, do not support removal of read file permissions. (profile, default: 0600) @@ -180,7 +182,7 @@ such as FAT32, do not support removal of read file permissions. .RS 5 An octal number which defines the permission bits for new folder directories. See -.BR chmod (1) +.IR chmod (1) for an explanation of the octal number. (profile, default: 700) .RE @@ -292,7 +294,7 @@ Indicates a default draft folder for and .BR repl . Read the -.BR mh\-draft (5) +.IR mh\-draft (5) man page for details. (profile, no default) .RE .PP @@ -348,7 +350,6 @@ puts in the \*(lqFrom:\*(rq header; do not include an address in the signature text. The \*(lqLocal\-Mailbox\*(rq profile component supersedes all of this. (profile, no default) .RE - .SS "Process Profile Entries" The following profile elements are used whenever an .B nmh @@ -394,7 +395,7 @@ Program called by .B mhl to filter a component when it is tagged with the \*(lqformat\*(rq variable in the mhl filter. See -.BR mhl (5) +.IR mhl (5) for more information. .RE .PP @@ -429,6 +430,9 @@ also used by the draft folder facility in and .B repl to display the draft message. +(Note that +.B $PAGER +supersedes the default built-in pager command.) .RE .PP .BR mailproc : @@ -488,6 +492,9 @@ formatted message when displaying to a terminal. It is also the default program used by .B mhshow to display message bodies (or message parts) of type text/plain. +(Note that +.B $PAGER +supersedes the default built-in pager command.) .RE .PP .BR mshproc : @@ -576,7 +583,6 @@ This is the program used by .B whatnow to determine to whom a message would be sent. .RE - .SS "Environment Variables" The operation of .B nmh @@ -827,6 +833,12 @@ profile entry will display debugging information about the values in that entry. .RE .PP +.B $PAGER +.RS 5 +If set to a non-null value, this supersedes the value of +the default built-in pager command. +.RE +.PP .B $editalt .RS 5 This is the alternate message. @@ -952,7 +964,6 @@ and .B repl if annotations are to occur. .RE - .SH FILES .fc ^ ~ .nf @@ -963,10 +974,10 @@ if annotations are to occur. ^or $MHCONTEXT~^Rather than the standard context ^/\&.mh\(rusequences~^Public sequences for .fi - .SH "SEE ALSO" -nmh(7), environ(5), mh-sequence(5) - +.IR environ (5), +.IR mh-sequence (5), +.IR nmh (7) .SH HISTORY The .I \&.mh\(ruprofile @@ -995,12 +1006,7 @@ lower-case). If the entry is not absolute (does not start with a .B nmh 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