X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/39a9d9d85d0f2289d8c1257251311b7cf959c700..2184c8815e03f092ceb640454ebc40fc10a1ea48:/man/mh-format.man diff --git a/man/mh-format.man b/man/mh-format.man index c2176532..8b43eda6 100644 --- a/man/mh-format.man +++ b/man/mh-format.man @@ -3,7 +3,7 @@ .\" %nmhwarning% . .SH NAME -mh-format \- format file for nmh message system +mh-format \- formatting language for nmh message system .SH DESCRIPTION Several .B nmh @@ -241,7 +241,7 @@ The function escapes may be roughly grouped into a few categories. .RS 5 .nf .ta \w'Fformataddr 'u +\w'Aboolean 'u +\w'Rboolean 'u -.I "Function Argument Result Description" +.I "Function Argument Return Description" msg integer message number cur integer message is current (0 or 1) unseen integer message is unseen (0 or 1) @@ -285,6 +285,7 @@ decode expr string decode \fIstr\fR as RFC 2047 (MIME-encoded) component unquote expr string remove RFC 2822 quotes from \fIstr\fR trim expr trim trailing whitespace from \fIstr\fR +trimr expr string Like %(trim), also returns string kilo expr string express in SI units: 15.9K, 2.3M, etc. %(kilo) scales by factors of 1000, kibi expr string express in IEC units: 15.5Ki, 2.2Mi. @@ -429,9 +430,12 @@ specified by their leading field width argument. For example, size in a field six characters wide filled with leading zeros; %14(\fIputstrf\^\fR{\fIfrom\^\fR}) will print the \*(lqFrom:\*(rq header component in fourteen characters with trailing spaces added as needed. -For \fIputstrf\fR, using a negative value for the field width causes -right-justification of the string within the field, with padding on +Using a negative value for the field width causes +right-justification within the field, with padding on the left up to the field width. +Padding is with spaces except for a left-padded +.I putnumf +when the width starts with zero. The functions (\fIputnum\fR\^) and (\fIputstr\fR\^) are somewhat special: they print their result in the minimum number of characters required, and ignore any leading field width @@ -775,6 +779,6 @@ at 4 digits. .SH "SEE ALSO" .IR scan (1), .IR repl (1), -.IR fmttest (1), +.IR fmttest (1) .SH CONTEXT None