X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/51919715ad7a57f2c74854a6d3d6374578f46985..c1e7215519ea50d95fc30d0a8064db6633a7d559:/man/mh-format.man?ds=sidebyside diff --git a/man/mh-format.man b/man/mh-format.man index dc2d9b0c..72a03862 100644 --- a/man/mh-format.man +++ b/man/mh-format.man @@ -1,4 +1,4 @@ -.TH MH-FORMAT %manext5% "November 4, 2012" "%nmhversion%" +.TH MH-FORMAT %manext5% "January 10, 2015" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -45,7 +45,8 @@ A format string consists of ordinary text, and special multi-character escape sequences which begin with `%'. When specifying a format string, the usual C backslash characters are honored: `\\b', `\\f', `\\n', `\\r', and `\\t'. Continuation lines in format files end with -`\\' followed by the newline character. +`\\' followed by the newline character. A literal `%' can be inserted into +a format file by using the sequence `%%'. .\" TALK ABOUT SYNTAX FIRST, THEN SEMANTICS .SS SYNTAX Format strings are built around @@ -136,7 +137,7 @@ For string valued functions or components, the condition is true if the function return or component value is a non-empty string, and false for an empty string. .PP -The `%?' control escape is optional, and may there may be more +The `%?' control escape is optional, and there may be more than one `%?' control escape in a conditional block. The `%|' control escape is also optional, but may be included at most once. @@ -267,6 +268,7 @@ match literal boolean \fIstr\fR contains \fIarg\fR amatch literal boolean \fIstr\fR starts with \fIarg\fR plus literal integer \fIarg\fR plus \fInum\fR minus literal integer \fIarg\fR minus \fInum\fR +multiply literal integer \fInum\fR multiplied by \fIarg\fR divide literal integer \fInum\fR divided by \fIarg\fR modulo literal integer \fInum\fR modulo \fIarg\fR num literal integer Set \fInum\fR to \fIarg\fR. @@ -365,7 +367,7 @@ mon date integer month of the year month date string month of the year (abbrev.) lmonth date string month of the year year date integer year (may be > 100) -zone date integer timezone in hours +zone date integer timezone in minutes tzone date string timezone string szone date integer timezone explicit? (1=explicit,0=implicit,\-1=unknown) @@ -394,7 +396,11 @@ addr addr string mbox@host or host!mbox rendering* pers addr string the personal name* note addr string commentary text* mbox addr string the local mailbox* -mymbox addr integer List has the user's address? (0 or 1) +mymbox addr integer list has the user's address? (0 or 1) +getmymbox addr string the user's (first) address, + with personal name +getmyaddr addr string the user's (first) address, + without personal name host addr string the host domain* nohost addr integer no host was present (0 or 1)* type addr integer host type* (0=local,1=network, @@ -445,7 +451,7 @@ output width. It can therefore be used for outputting terminal escape sequences. .PP There are a limited number of function escapes to output terminal escape -sequences. These sequences are retrieved from the +sequences. These sequences are retrieved from the .IR terminfo (5) database according to the current terminal setting. The (\fIbold\fR\^), (\fIunderline\fR\^), and (\fIstandout\fR\^) escapes set bold mode, @@ -494,7 +500,7 @@ the From: and Reply-To: headers: .fi .RE .PP -Unfortuantely if the Reply-to: header is NOT present, the output line that is +Unfortunately if the Reply-to: header is NOT present, the output line that is generated will be something like: .PP .RS 5 @@ -577,7 +583,7 @@ a space should be printed. Next: .RE .PP the month and date are printed in two digits (zero filled) separated by -a slash. Next, +a slash. Next, .PP .RS 5 .nf @@ -751,7 +757,7 @@ to have far more than 10000 messages. .\" process 200 messages a day and still get some real work .\" done." The authors apparently only planned to get .\" real work done for about 50 days per folder.) -Nontheless (as noted above) +Nonetheless (as noted above) the various scan format strings are inherited from older MH versions, and are generally hard-coded to 4 digits of message number before formatting problems