X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fap.man8;h=c96770ce620c6a9dd5fad39e480f9a02f096710d;hp=0a5ac5a8fb1ae8eb6a42a696a1fbbf6cd750f17c;hb=32b2354dbaf4bf934936eb5b102a4a3d2fdd209a;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9 diff --git a/man/ap.man8 b/man/ap.man8 index 0a5ac5a..c96770c 100644 --- a/man/ap.man8 +++ b/man/ap.man8 @@ -10,12 +10,8 @@ ap \- parse addresses 822-style .B %libdir%/ap .RB [ \-form .IR formatfile ] -.RB [ \-format -.IR string ] .RB [ \-normalize " | " \-nonormalize ] -.RB [ \-width -.IR columns ] -.RB [ \-version ] +.RB [ \-Version ] .RB [ \-help ] .I addrs \&... @@ -37,14 +33,15 @@ usually best to enclose each argument in double\-quotes for the shell. To override the output format used by .BR ap , the -.B \-format -.I string -or -.B \-format +.B \-form .I file -switches are used. This permits individual fields of -the address to be extracted with ease. The string is simply a format -string, and the file is simply a format file. See +switch is used. This permits individual fields of +the address to be extracted with ease. +The +.I file +is either the name of a format file or it may be +a format string directly, if prepended with an equal sign `='. +See .BR mh\-format (5) for the details. .PP @@ -55,7 +52,7 @@ also recognizes the following additional escape: .RS 5 .nf .ta \w'Escape 'u +\w'Returns 'u -.I Escape Returns Description +.I "Escape Returns Description error string A diagnostic if the parse failed .RE .fi @@ -71,7 +68,9 @@ Here is the default format string used by .BR ap : .PP .RS 5 +.nf %<{error}%{error}: %{text}%|%(putstr(proper{text}))%> +.fi .RE .PP which says that if an error was detected, print the error, a `:', and @@ -83,7 +82,6 @@ the address. .nf .ta \w'%etcdir%/ExtraBigFileName 'u ^$HOME/.mmh/profile~^The user profile -^%etcdir%/mts.conf~^nmh mts configuration file .fi .SH "PROFILE COMPONENTS" @@ -96,19 +94,9 @@ dp(8), .SH DEFAULTS .nf -.RB ` \-format "' defaults as described above" +.RB ` \-form "' defaults as described above" .RB ` \-normalize ' -.RB ` \-width "' defaults to the width of the terminal" .fi .SH CONTEXT None - -.SH BUGS -The argument to the -.B \-format -switch must be interpreted as a single token -by the shell that invokes -.BR ap . -Therefore, -one must usually place the argument to this switch inside double\-quotes.