X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fap.man;h=f1b6faa44804f76db4976f41e38a969b86c5af2c;hb=706236baa4c4670b5a074092dec5dec63ff50663;hp=ec6808b7a1936414067f9163b9e7f7936e1e5c5a;hpb=f90104a1c52886ee18a4af23b67535530b59f920;p=mmh diff --git a/man/ap.man b/man/ap.man index ec6808b..f1b6faa 100644 --- a/man/ap.man +++ b/man/ap.man @@ -1,12 +1,12 @@ +.TH AP %manext8% "November 6, 2012" "%nmhversion%" .\" .\" %nmhwarning% -.\" $Id$ .\" -.TH AP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME ap \- parse addresses 822-style .SH SYNOPSIS .HP 5 +.na .B %libdir%/ap .RB [ \-form .IR formatfile ] @@ -17,7 +17,9 @@ ap \- parse addresses 822-style .IR columns ] .RB [ \-version ] .RB [ \-help ] -.IR addrs " ..." +.I addrs +\&... +.ad .SH DESCRIPTION .B Ap is a program that parses addresses according to the ARPA @@ -30,18 +32,20 @@ The .B ap program treats each argument as one or more addresses, and prints those addresses out in the official 822\-format. Hence, it is -usually best to enclose each argument in double\-quotes for the shell. +usually best to enclose each argument in quotes for the shell. .PP To override the output format used by .BR ap , the -.BI \-format " string" +.B \-format +.I string or -.BI \-format " file" +.B \-format +.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 -.BR mh\-format (5) +.IR mh\-format (5) for the details. .PP In addition to the standard escapes, @@ -49,10 +53,9 @@ In addition to the standard escapes, also recognizes the following additional escape: .PP .RS 5 -.fc ^ ~ .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 @@ -74,35 +77,26 @@ Here is the default format string used by which says that if an error was detected, print the error, a `:', and the address in error. Otherwise, output the 822\-proper format of the address. - .SH FILES .fc ^ ~ .nf -.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u +.ta \w'%etcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile ^%etcdir%/mts.conf~^nmh mts configuration file - +.fi .SH "PROFILE COMPONENTS" None - .SH "SEE ALSO" -dp(8), -.IR "Standard for the Format of ARPA Internet Text Messages" " (RFC\-822)" - -.SH "DEFAULTS" +.IR dp (8) +.PP +.I +Standard for the Format of ARPA Internet Text Messages +(RFC\-822) +.SH DEFAULTS .nf .RB ` \-format "' 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.