Package: sendmail
Version: 8.14.4-5
Tags: patch
Usertags: origin-ubuntu ubuntu-patch utopic
In Ubuntu, we've applied the attached patch to achieve the following:
* debian/examples/checksendmail/checksendmail.8,
debian/examples/checksendmail/harker/checksendmail.8::
- Some man page corrections.
We thought you might be interested in doing the same.
diff -Nru sendmail-8.14.4/debian/examples/checksendmail/checksendmail.8 sendmail-8.14.4/debian/examples/checksendmail/checksendmail.8
--- sendmail-8.14.4/debian/examples/checksendmail/checksendmail.8 2014-02-16 00:49:47.000000000 +0100
+++ sendmail-8.14.4/debian/examples/checksendmail/checksendmail.8 2014-02-16 05:16:53.000000000 +0100
@@ -3,10 +3,10 @@
.Dt CHECKSENDMAIL 8
.Os
.Sh NAME
-.Nm checksendmail
+.Nm checksendmail
.Nd verify sendmail address transformations.
.Sh SYNOPSIS
-.Nm checksendmail
+.Nm checksendmail
.Op Fl a
.Op Fl d
.Op Fl b
@@ -17,19 +17,20 @@
.Op Fl T Ar test.address
.Sh DESCRIPTION
.Pp
-The
+The
.Nm checksendmail
-program is a
+program is a
.Xr perl
-script that aids the testing of
-.Xr sendmail 8 's
+script that aids the testing of
+.\".Xr sendmail 8 's
+sendmail(8)'s
various configuration files.
-.Nm checksendmail
+.Nm checksendmail
passes typical addresses (supplied in input files) through
.Xr sendmail
and prints the results of the resolution and transformation routines.
.Pp
-The input files contain a list of addresses, one per line.
+The input files contain a list of addresses, one per line.
For example:
.Bd -literal -offset indent
user
@@ -37,29 +38,29 @@
u...@site.com
.Ed
.Pp
-The input file can contain comments started with a
-.Em #
+The input file can contain comments started with a
+.Em #
and blank lines.
.Sh OPTIONS
.Pp
.Bl -tag -width Fl -compact -offset left
.It Fl a
-Show aliasing of local addresses in
+Show aliasing of local addresses in
mail address resolution phase of testing
.It Fl d
-Preceed each address translation line with ruleset sequence summary
+Precede each address translation line with ruleset sequence summary
.It Fl C Ar file.cf
-Use the
+Use the
.Xr sendmail
-configuration file
+configuration file
.Ar file.cf
-instead of the default
+instead of the default
.Pa /etc/sendmail.cf
file.
.It Fl b Ar sendmail_binary
Use the specified
.Ar sendmail_binary
-as the path to invoke sendmail (instead of
+as the path to invoke sendmail (instead of
.Pa /usr/sbin/sendmail ) .
.It Fl l Ar log_file
Log
@@ -80,12 +81,12 @@
.El
.Sh EXAMPLES
.Pp
-The following command will pass the addresses in
+The following command will pass the addresses in
.Ar address.resolve
-through
-.Xr sendmail
-using the configuration information in
-.Ar myconfig.cf .
+through
+.Xr sendmail
+using the configuration information in
+.Ar myconfig.cf .
.Bd -literal -offset left
example% cat address.resolve
user
@@ -115,38 +116,38 @@
.Ed
.Pp
The first section of the output shows how the addresses in the input
-files are resolved by
+files are resolved by
.Xr sendmail 8 .
Consider the following output line:
.Pp
-.Dl u...@site.com --(ether )--> u...@site.com[rmtc]
+.Dl "u...@site.com --(ether )--> u...@site.com[rmtc]"
.Pp
-The input address
+The input address
.Em u...@site.com
-resolves to use the
+resolves to use the
.Em ether
mailer. That mailer is directed to send the mail to
-to the user
+to the user
.Em u...@site.com
-at site
+at site
.Em rmtc
(as indicated in the square brackets).
.Pp
The two later sections of output show how the addresses specified as
-the
-.Em To
-and
-.Em From
+the
+.Em To
+and
+.Em From
address are transformed in the text of the
-headers. In the example above, the
-.Em To
+headers. In the example above, the
+.Em To
addresses are untouched.
-The
-.Em From
+The
+.Em From
addresses, however, all lose their machine information on
the way through the mailer:
.Pp
-.Dl user@site ----> user
+.Dl "user@site ----> user"
.Pp
This may be desirable when using a configuration file on a
workstation which is to be hidden as a mailhost from the rest of the
@@ -199,7 +200,7 @@
.It u...@machine.dom.sun.com
fully qualified but unknown machine
.It u...@foo.com
-standard, known, really far away domain
+standard, known, really far away domain
.It u...@foo.dom
standard, unknown, really far away domain
.It site!user
@@ -214,24 +215,24 @@
Mixed double uucp/domain
.El
.Sh NOTES
-Note that
+Note that
.Nm checksendmail
-is a
-.Xr perl
+is a
+.Xr perl
script. If your site does not have
.Xr perl 1 ,
it can be obtained via anonymous
.Xr ftp
-from
+from
.Em ftp.uu.net .
.Pp
.Xr sendmail
-requires that the user have access to directory specified by the
+requires that the user have access to directory specified by the
.Em OQ
-parameter in the configuration file (normally
+parameter in the configuration file (normally
.Pa /usr/spool/mqueue ) .
.Nm checksendmail
-verifies that the user has access to this directory before allowing the
+verifies that the user has access to this directory before allowing the
test to continue.
.Sh AUTHORS
.Bd -literal
diff -Nru sendmail-8.14.4/debian/examples/checksendmail/harker/checksendmail.8 sendmail-8.14.4/debian/examples/checksendmail/harker/checksendmail.8
--- sendmail-8.14.4/debian/examples/checksendmail/harker/checksendmail.8 2014-02-16 00:49:47.000000000 +0100
+++ sendmail-8.14.4/debian/examples/checksendmail/harker/checksendmail.8 2014-02-16 05:16:53.000000000 +0100
@@ -3,10 +3,10 @@
.Dt CHECKSENDMAIL 8
.Os
.Sh NAME
-.Nm checksendmail
+.Nm checksendmail
.Nd verify sendmail address transformations.
.Sh SYNOPSIS
-.Nm checksendmail
+.Nm checksendmail
.Op Fl a
.Op Fl d
.Op Fl b
@@ -15,22 +15,22 @@
.Op Fl l Ar log_file
.Op Fl r Ar resolve
.Op Fl T Ar test.address
-
.Sh DESCRIPTION
.Pp
-The
+The
.Nm checksendmail
-program is a
+program is a
.Xr perl
-script that aids the testing of
-.Xr sendmail 8 's
+script that aids the testing of
+.\".Xr sendmail 8 's
+sendmail(8)'s
various configuration files.
-.Nm checksendmail
+.Nm checksendmail
passes typical addresses (supplied in input files) through
.Xr sendmail
and prints the results of the resolution and transformation routines.
.Pp
-The input files contain a list of addresses, one per line.
+The input files contain a list of addresses, one per line.
For example:
.Bd -literal -offset indent
user
@@ -38,29 +38,29 @@
u...@site.com
.Ed
.Pp
-The input file can contain comments started with a
-.Em #
+The input file can contain comments started with a
+.Em #
and blank lines.
.Sh OPTIONS
.Pp
.Bl -tag -width Fl -compact -offset left
.It Fl a
-Show aliasing of local addresses in
+Show aliasing of local addresses in
mail address resolution phase of testing
.It Fl d
-Preceed each address translation line with ruleset sequence summary
+Precede each address translation line with ruleset sequence summary
.It Fl C Ar file.cf
-Use the
+Use the
.Xr sendmail
-configuration file
+configuration file
.Ar file.cf
-instead of the default
+instead of the default
.Pa /etc/sendmail.cf
file.
.It Fl b Ar sendmail_binary
Use the specified
.Ar sendmail_binary
-as the path to invoke sendmail (instead of
+as the path to invoke sendmail (instead of
.Pa /usr/sbin/sendmail ) .
.It Fl l Ar log_file
Log
@@ -81,12 +81,12 @@
.El
.Sh EXAMPLES
.Pp
-The following command will pass the addresses in
+The following command will pass the addresses in
.Ar address.resolve
-through
-.Xr sendmail
-using the configuration information in
-.Ar myconfig.cf .
+through
+.Xr sendmail
+using the configuration information in
+.Ar myconfig.cf .
.Bd -literal -offset left
example% cat address.resolve
user
@@ -116,38 +116,38 @@
.Ed
.Pp
The first section of the output shows how the addresses in the input
-files are resolved by
+files are resolved by
.Xr sendmail 8 .
Consider the following output line:
.Pp
-.Dl u...@site.com --(ether )--> u...@site.com[rmtc]
+.Dl "u...@site.com --(ether )--> u...@site.com[rmtc]"
.Pp
-The input address
+The input address
.Em u...@site.com
-resolves to use the
+resolves to use the
.Em ether
mailer. That mailer is directed to send the mail to
-to the user
+to the user
.Em u...@site.com
-at site
+at site
.Em rmtc
(as indicated in the square brackets).
.Pp
The two later sections of output show how the addresses specified as
-the
-.Em To
-and
-.Em From
+the
+.Em To
+and
+.Em From
address are transformed in the text of the
-headers. In the example above, the
-.Em To
+headers. In the example above, the
+.Em To
addresses are untouched.
-The
-.Em From
+The
+.Em From
addresses, however, all lose their machine information on
the way through the mailer:
.Pp
-.Dl user@site ----> user
+.Dl "user@site ----> user"
.Pp
This may be desirable when using a configuration file on a
workstation which is to be hidden as a mailhost from the rest of the
@@ -200,7 +200,7 @@
.It u...@machine.dom.sun.com
fully qualified but unknown machine
.It u...@foo.com
-standard, known, really far away domain
+standard, known, really far away domain
.It u...@foo.dom
standard, unknown, really far away domain
.It site!user
@@ -215,24 +215,24 @@
Mixed double uucp/domain
.El
.Sh NOTES
-Note that
+Note that
.Nm checksendmail
-is a
-.Xr perl
+is a
+.Xr perl
script. If your site does not have
.Xr perl 1 ,
it can be obtained via anonymous
.Xr ftp
-from
+from
.Em ftp.uu.net .
.Pp
.Xr sendmail
-requires that the user have access to directory specified by the
+requires that the user have access to directory specified by the
.Em OQ
-parameter in the configuration file (normally
+parameter in the configuration file (normally
.Pa /usr/spool/mqueue ) .
.Nm checksendmail
-verifies that the user has access to this directory before allowing the
+verifies that the user has access to this directory before allowing the
test to continue.
.Sh AUTHORS
.Bd -literal
