Hi Justin, On Fri, Aug 23, 2013 at 02:44:14PM +0100, Justin B Rye wrote: > Sure! Brace yourself, I'm setting pedantry levels up to 11. Great, thanks! I've only replied to those parts to which I have something to add; otherwise, assume I'm in full agreement. > > Template: opensmtpd/mailname > > couldn't we make it clearer that "mail addresses without a domain > name" means "addresses for locally generated emails"? (Does it in > fact ever mean anything else?) Not to my knowledge; at least based off of this SMTP exchange: 220 ryanak.ca ESMTP OpenSMTPD EHLO master.debian.org 250-upsilon.ryanak.ca Hello master.debian.org [IPv6:2001:41b8:202:deb:216:36ff:fe40:4001], pleased to meet you 250-8BITMIME 250-ENHANCEDSTATUSCODES 250-SIZE 36700160 250-STARTTLS 250 HELP MAIL FROM: <rak@debian.org> 250 Ok RCPT TO: <ryan> 553 Recipient address syntax error > The trouble with mentioning example.org here is that we want to be > able to use it later as an example valid FQDN, skating over the fact > that I don't have permission to use it... We can use it in documentation; see http://tools.ietf.org/html/rfc2606#section-3 . > The mailname is the "default" hostname used in the SMTP greeting > banner? Default in what sense? (Also, demote this to a later > paragraph.) Default in the sense that it gets used in the 220 reply (e.g., ryanak.ca above) unless you configure opensmtpd to use a different hostname via /etc/smtpd.conf > You can probably persuade me that some of those criticisms are > unnecessary, but here's an attempted full rewrite: Looks great, thanks! > > Template: opensmtpd/root_address > > Enter a comma-separated list of usernames to which this mail should > > go. Leave this field blank to not create an alias for 'root'; in > > this case, the 'root' account will receive mail destined to > > 'postmaster' and other system accounts, assuming aliases for these > > accounts do not already exist. > > Next quibble: mail doesn't go to usernames - it goes to users (or > maybe I should say user mailboxes). Is there a fix that doesn't just > sound awkward? Correct, it usually goes to a user mailbox. In reality, it can go to a file, get piped into a program, go to the mailbox of a local user, or get forwarded to a remote email address (see alias(5)). I had contemplated refering users to alias(5), but I don't know that it's guaranteed to exist, and I think most people specify usernames regardless. As for reformulation that isn't awkward, I don't know of any, sorry. > A rewritten version: Great, thanks! > _Description: Root and postmaster mail recipient: > Mail for the "postmaster", "root", and other system accounts should be > redirected to the user account(s) of the actual system administrator(s). > . > Please enter a comma-separated list of usernames of intended recipients. Grammar question: Why is there no article "the" preceeding "intended recipients"? May I add a copyright line on your behalf to debian/copyright licensing your changes under the package's license (ISC[0])? Thanks for your feedback! Best wishes, Ryan [0] http://opensource.org/licenses/ISC -- |_)|_/ Ryan Kavanagh | Debian Developer | \| \ http://ryanak.ca/ | GPG Key 4A11C97A
Attachment:
signature.asc
Description: Digital signature