| Well, deliver to mda has exactly the same issue.  I'd say that format
| specifiers could use their own subsection.
| 
| While here I propose to replace \&" by \(dq, as advised by
| mandoc_char(7).  This has the nice property of not fscking up the
| display of your too-smart-for-its-own-good editor.
| 
| Does this look better?

Yes, and ok brett@.

| 
| Index: smtpd.conf.5
| ===================================================================
| RCS file: /cvs/src/usr.sbin/smtpd/smtpd.conf.5,v
| retrieving revision 1.113
| diff -u -p -p -u -r1.113 smtpd.conf.5
| --- smtpd.conf.5      6 Dec 2013 10:42:15 -0000       1.113
| +++ smtpd.conf.5      12 Dec 2013 23:05:29 -0000
| @@ -39,7 +39,7 @@ the comment is effective until the end o
|  Argument names not beginning with a letter, digit, or underscore
|  must be quoted.
|  Arguments containing whitespace should be surrounded by double quotes
| -.Pq \&" .
| +.Pq \(dq .
|  .Pp
|  Macros can be defined that will later be expanded in context.
|  Macro names must start with a letter, digit, or underscore,
| @@ -288,7 +288,7 @@ Mail is added to a maildir.
|  Its location,
|  .Ar path ,
|  may contain format specifiers that are expanded before use
| -(see above).
| +.Pq see Sx "FORMAT SPECIFIERS" .
|  If
|  .Ar path
|  is not provided, then
| @@ -302,7 +302,7 @@ Mail is piped to the specified
|  .Ar program ,
|  which is run with the privileges of the user the message is destined to.
|  This parameter may use conversion specifiers that are expanded before use
| -(see above).
| +.Pq see Sx "FORMAT SPECIFIERS" .
|  .It Xo
|  .Ic relay
|  .Op Ic backup Op Ar mx
| @@ -806,7 +806,7 @@ many mappings as a list of comma separat
|  .Ar key Ns = Ns Ar value
|  descriptions.
|  .El
| -.Pp
| +.Ss "FORMAT SPECIFIERS"
|  Some configuration directives support expansion of their parameters at 
runtime.
|  Such directives (for example
|  .Ar deliver to maildir ,

Reply via email to