X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/f7b01171f451e5a173b6e91dee0cb65bad641dc8..c87ca5cca:/man/fmttest.man?ds=inline

diff --git a/man/fmttest.man b/man/fmttest.man
index 17d7d300..e92586af 100644
--- a/man/fmttest.man
+++ b/man/fmttest.man
@@ -1,4 +1,4 @@
-.TH FMTTEST %manext1% "February 19, 2013" "%nmhversion%"
+.TH FMTTEST %manext1% "August 31, 2014" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -15,15 +15,13 @@ language
 .RB [ \-format
 .IR formatstring ]
 .RB [ \-address " | " \-raw " | " \-date " | " \-message ]
+.RB [ \-file " | " \-nofile ]
 .RB [ \-\|\-component
 .IR component-text ]
 .RB [ \-dupaddrs " | " \-nodupaddrs ]
 .RB [ \-ccme " | " \-noccme ]
-.RB [ \-normalize " | " \-nonormalize ]
 .RB [ \-outsize
 .IR size-in-characters ]
-.RB [ \-bufsize
-.IR size-in-bytes ]
 .RB [ \-width
 .IR column-width ]
 .RB [ \-msgnum
@@ -71,7 +69,7 @@ rules: absolute pathnames are accessed directly, tilde expansion is
 done on usernames, and files are searched for in the user's
 .I Mail
 directory as specified in their profile.  If not found there, the directory
-.RI \*(lq %etcdir% \*(rq
+.RI \*(lq %nmhetcdir% \*(rq
 is checked.
 .SS MODE SELECTION AND COMPONENT SPECIFICATION
 .B Fmttest
@@ -103,8 +101,8 @@ following default program is used:
 .PP
 In this mode
 .B fmttest
-is equivant to
-.BR ap (8).
+is equivalent to
+.IR ap (8).
 .PP
 In raw mode, no processing of the specified arguments is done.  Each argument
 is run against the specified format program with the argument text available
@@ -126,7 +124,7 @@ specified, the following format string is used:
 .RE
 .PP
 Date mode is equivalent to
-.BR dp (8).
+.IR dp (8).
 .PP
 In message mode the arguments to
 .B fmttest
@@ -140,7 +138,15 @@ for the
 .RI %( unseen ),
 and
 .RI %( size )
-function escapes will be made available for each message.
+function escapes will be made available for each message.  If the
+.B \-file
+switch is given, the arguments are interpreted as filenames instead of
+message numbers, but otherwise the behavior is the same (except that the
+.RI %( msg ),
+.RI %( cur ),
+and
+.RI %( unseen )
+function escapes will not provide any useful information).
 .PP
 The default format used in address mode is the default format used by
 .BR scan .
@@ -198,15 +204,6 @@ and only applies if
 is in effect.
 .PP
 The
-.B \-normalize
-and
-.B \-nonormalize
-switches control whether or not email addresses are normalized by the
-address parsing routines.  This is only functional when in address
-mode and is designed to replicate the switch of the same name to
-.BR ap (8).
-.PP
-The
 .B \-outsize
 switch controls the maximum number of printable characters that the format
 engine will produce.  Characters marked as non-printing by the format
@@ -215,20 +212,15 @@ engine with
 characters with zero width, and extra bytes that are
 part of a multibyte character are not counted against this total.
 Two special values are supported:
-.RB \*(lq max \*(rq,
-which will set the value
-to the size of the output buffer, and
-.RB \*(lq width \*(rq,
+.RI \*(lq max \*(rq,
+which means as many characters as the format engine can produce
+(limited by internal buffers), and
+.RI \*(lq width \*(rq,
 which will set the
-value to the width of the terminal.  In message mode it defaults to the
-terminal width, otherwise the default is the output buffer size.
-.PP
-The
-.B \-bufsize
-switch controls the size of the output buffer.  By default it is set
-to the size of the
-.B BUFSIZ
-C preprocessor symbol, which is system-dependent.
+value to the width of the terminal.  In message mode it defaults to
+.RI \*(lq width \*(rq,
+otherwise the default is
+.RI \*(lq max \*(rq.
 .PP
 The
 .B \-width
@@ -256,7 +248,8 @@ The
 .B \-dump
 switch outputs the complete set of format instructions for the specified
 format program.  The
-.B \-trace switch will output each format instruction as it is being
+.B \-trace
+switch will output each format instruction as it is being
 executed, and show the values of the
 .I num
 and
@@ -296,8 +289,8 @@ STRLITZ	Like \fBSTRLIT\fR, but not counted against width
 LS_COMP	Write component to \fIstr\fR register
 LS_LIT	Write literal to \fIstr\fR register
 LS_GETENV	Write environment var to \fIstr\fR register
-LS_DECODECOMP	Decode RFC-2047 encoded component to \fIstr\fR register
-LS_DECODE	Decode RFC-2047 encoded string to \fIstr\fR register
+LS_DECODECOMP	Decode RFC 2047 encoded component to \fIstr\fR register
+LS_DECODE	Decode RFC 2047 encoded string to \fIstr\fR register
 LS_TRIM		Trim trailing whitespace from \fIstr\fR register
 LV_COMP		Convert component to integer, store in \fInum\fR register
 LV_COMPFLAG	Set \fInum\fR to 1 if \fBTRUE\fR set in component
@@ -314,7 +307,7 @@ LS_LMONTH	Write long name of month to \fIstr\fR from date component
 LS_ZONE		Write time zone offset to \fIstr\fR from date component
 LS_DAY		Write short name of day of week to \fIstr\fR from date component
 LS_WEEKDAY	Write long name of day of week to \fIstr\fR from date component
-LS_822DATE	Write RFC-822 compatible date to \fIstr\fR from date component
+LS_822DATE	Write RFC 822 compatible date to \fIstr\fR from date component
 LS_PRETTY	Write date with \*(lqpretty\*(rq timezone to \fIstr\fR
 LV_SEC	Write date component seconds to \fInum\fR
 LV_MIN	Write date component minutes to \fInum\fR
@@ -336,8 +329,9 @@ LS_HOST	Write host of addr component to \fIstr\fR
 LS_PATH	Write host route of addr component to \fIstr\fR
 LS_GNAME	Write group name of addr component to \fIstr\fR
 LS_NOTE	Write note portion of addr component to \fIstr\fR
-LS_822ADDR	Write \*(lqproper\*(rq RFC-822 version of addr component to \fIstr\fR
+LS_822ADDR	Write \*(lqproper\*(rq RFC 822 version of addr component to \fIstr\fR
 LS_FRIENDLY	Write friendly (name or note) of address component to \fIstr\fR
+LS_UNQUOTE	Remove RFC 2822 quotes from string
 LV_HOSTTYPE	Set \fInum\fR to type of host (0=local, 1=network)
 LV_INGRPF	Set \fInum\fR to 1 if address was inside of group
 LV_NOHOSTF	Set \fInum\fR to 1 of no host was present in address component
@@ -365,7 +359,7 @@ V_EQ	Set \fInum\fR to 1 if \fInum\fR equals value
 V_NE	Set \fInum\fR to 1 if \fInum\fR does not equal value
 V_GT	Set \fInum\fR to 1 if \fInum\fR is greater than value
 V_MATCH	Set \fInum\fR to 1 if \fIstr\fR contains string
-V_AMATCH Set \fInum\fR to 1 if \fIstr\fR starts with string
+V_AMATCH	Set \fInum\fR to 1 if \fIstr\fR starts with string
 .fi
 .PP
 The
@@ -392,6 +386,7 @@ dat[4]	%(\fIunseen\fR)
 .SH DEFAULTS
 .nf
 .RB ` \-message '
+.RB ` \-nofile '
 .RB ` \-dupaddrs '
 .fi
 .SH BUGS