X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/9530e8f7f96f79ebe9afaeeecf0f2a2b373bb429..b18f2d1fcd634e79fff9d69bc9b7ddf220755290:/man/mh-format.man?ds=sidebyside

diff --git a/man/mh-format.man b/man/mh-format.man
index 8b43eda6..22233b65 100644
--- a/man/mh-format.man
+++ b/man/mh-format.man
@@ -269,8 +269,8 @@ num		integer	Set \fInum\fR to zero.
 lit 	literal	string	Set \fIstr\fR to \fIarg\fR.
 lit		string	Clear \fIstr\fR.
 getenv 	literal	string	Set \fIstr\fR to environment value of \fIarg\fR
-profile	literal	string	Set \fIstr\fR to profile component \fIarg\fR
-			value
+profile	literal	string	Set \fIstr\fR to profile or context
+			component \fIarg\fR value
 .\" dat	literal	int	return value of dat[arg]
 nonzero	expr	boolean	\fInum\fR is non-zero
 zero	expr	boolean	\fInum\fR is zero
@@ -290,6 +290,8 @@ 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.
 			%(kibi) scales by factors of 1024.
+ordinal	expr	string	Output ordinal suffix based on value
+			of \fInum\fR (st, nd, rd, th)
 putstr	expr		print \fIstr\fR
 putstrf	expr		print \fIstr\fR in a fixed width
 putnum	expr		print \fInum\fR
@@ -412,6 +414,13 @@ It returns true if any address matches. However, it also returns true
 if the \*(lq\fIcomp\fR\*(rq header is not present in the message.
 If needed, the (\fInull\fR\^) function can be used to explicitly
 test for this case.)
+.PP
+The \fIfriendly\fR\^{\fIcomp\fR\^}) call will return any double-quoted
+\*(lqpersonal name\*(rq (that is, anything before <>), then it will return
+that.  If there's no personal name but there is a
+\*(lqnote\*(rq (comments string after an email address), it will return
+that.  If there is neither of those it will just return the bare email address.
+
 .SS Formatting
 When a function or component escape is interpreted and the result will
 be printed immediately, an optional field width can be specified to