X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fap.man8;h=699e9938e595ffd5cfb828bb884fab0a7ead6dee;hp=af967dff864c2b35abd4b7fb52d22bfafd3a54a4;hb=0073224c28bf81dad1812d406bb9915b24b23eb6;hpb=d3540eaa4251b3a282115a72ed5d1bb39ce74b3f diff --git a/man/ap.man8 b/man/ap.man8 index af967df..699e993 100644 --- a/man/ap.man8 +++ b/man/ap.man8 @@ -10,11 +10,7 @@ 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 [ \-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 @@ -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 @@ -95,9 +94,8 @@ 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 @@ -105,7 +103,7 @@ None .SH BUGS The argument to the -.B \-format +.B \-form switch must be interpreted as a single token by the shell that invokes .BR ap .