Unify @ref and @command usage

[nncp.git] / doc / integration / postfix.texi

diff --git a/doc/integration/postfix.texi b/doc/integration/postfix.texi
index f597ea9bfe6ec689aecaeb5112dab1161fdb41f2..3ad4807a82404cde4dee71efa3ddf9def08952ed 100644 (file)
--- a/doc/integration/postfix.texi
+++ b/doc/integration/postfix.texi
@@ -1,4 +1,6 @@
 @node Postfix
+@cindex Postfix integration
+@pindex postfix
 @section Integration with Postfix
 
 This section is taken from @url{http://www.postfix.org/UUCP_README.html,
@@ -12,9 +14,9 @@ mail to a LAN that is connected via NNCP.
 
 @itemize
 
-@item You need an @ref{nncp-exec} program that extracts the sender
-address from mail that arrives via NNCP, and that feeds the mail into
-the Postfix @command{sendmail} command.
+@item You need an @command{@ref{nncp-exec}} program that extracts the
+sender address from mail that arrives via NNCP, and that feeds the mail
+into the Postfix @command{sendmail} command.
 
 @item Define a @command{pipe(8)} based mail delivery transport for
 delivery via NNCP:
@@ -24,13 +26,16 @@ nncp      unix  -       n       n       -       -       pipe
   flags=Rqhu user=nncp argv=nncp-exec -quiet $nexthop sendmail $recipient
 @end example
 
-This runs the @command{nncp-exec} command to place outgoing mail into
+This runs the @command{@ref{nncp-exec}} command to place outgoing mail into
 the NNCP queue after replacing @var{$nexthop} by the receiving NNCP
 node and after replacing @var{$recipient} by the recipients. The
-@command{pipe(8)} delivery agent executes the @command{nncp-exec}
+@command{pipe(8)} delivery agent executes the @command{@ref{nncp-exec}}
 command without assistance from the shell, so there are no problems with
 shell meta characters in command-line parameters.
 
+@pindex sendmail.sh
+@vindex Return-Path
+@pindex reformail
 Pay attention to @code{flags}, containing @code{R}, telling Postfix to
 include @code{Return-Path:} header. Otherwise that envelope sender
 information may be lost. Possibly you will also need somehow to
@@ -42,6 +47,9 @@ extract with:
 
 @verbatiminclude sendmail.sh
 
+@vindex From_
+@cindex mbox
+@pindex maildrop
 Also pay attention that @command{maildrop} does not like @code{From_}
 mbox-style header, so you possibly want:
 
@@ -75,7 +83,7 @@ willing to relay mail for.
 
 @example
 /usr/local/etc/postfix/main.cf:
-    relay_domains = example.com ...other relay domains...
+    relay_domains = example.com @dots{}other relay domains@dots{}
 @end example
 
 See the @option{relay_domains} configuration parameter description for
@@ -92,9 +100,9 @@ Here is how to relay mail from a LAN via NNCP to the Internet.
 
 @itemize
 
-@item You need an @ref{nncp-exec} program that extracts the sender
-address from mail that arrives via NNCP, and that feeds the mail into
-the Postfix @command{sendmail} command.
+@item You need an @command{@ref{nncp-exec}} program that extracts the
+sender address from mail that arrives via NNCP, and that feeds the mail
+into the Postfix @command{sendmail} command.
 
 @item Specify that all remote mail must be sent via the @command{nncp}
 mail transport to your NNCP gateway host, say, @emph{nncp-gateway}:
@@ -121,10 +129,10 @@ nncp      unix  -       n       n       -       -       pipe
   flags=Fqhu user=nncp argv=nncp-exec -quiet $nexthop sendmail $recipient
 @end example
 
-This runs the @command{nncp-exec} command to place outgoing mail into
+This runs the @command{@ref{nncp-exec}} command to place outgoing mail into
 the NNCP queue. It substitutes the hostname (@emph{nncp-gateway}, or
 whatever you specified) and the recipients before execution of the
-command. The @command{nncp-exec} command is executed without assistance
+command. The @command{@ref{nncp-exec}} command is executed without assistance
 from the shell, so there are no problems with shell meta characters.
 
 @item Execute the command @command{postfix reload} to make the changes