Brett Mahar <[email protected]> writes:

> Hi,

Hi,

> This points me in the right direction so I'm less confused.
>
> ok?

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?

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