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