On Apr 30, 2014, at 9:57 PM, Stephen J. Turnbull <step...@xemacs.org> wrote:

> May as well rewrite the doc ... here goes:
> 
>    from_alignment:  Try to ensure that From is not "misaligned" with
>    the author's domain, to conform with protocols like DMARC.
>    [FIXME: I don't see how to avoid the double negative.  Help?!]

Seems to me saying “Try to ensure that 'From:' is “aligned” with …” does it. 
I’d prefer to put the header field name in quotes or otherwise distinguish it. 
Otherwise, it can be difficult to parse - is “from” the header or a preposition.

But, I don’t like “author’s domain”. Who or what is the author? Why not just 
say “the Mailman server’s domain” since that’s what it’s going to be aligned 
with. 

>    'no': Do nothing special.  This is appropriate for anonymous lists.
>    It is appropriate for dedicated announcement lists, unless the
>    "From" address is not within the Mailman host's domain.  [FIXME:
>    Maybe None is a better value here.  Of course that's not backward
>    compatible, but with the name change it would be possible to check
>    the old from_is_list.]

None is better. No would only be appropriate if ‘yes’ was the other option. But 
backwards compatibility is important too (even if it’s not to most large 
computer companies :-( ).


-- 
Larry Stone
lston...@stonejongleux.com
http://www.stonejongleux.com/



------------------------------------------------------
Mailman-Users mailing list Mailman-Users@python.org
https://mail.python.org/mailman/listinfo/mailman-users
Mailman FAQ: http://wiki.list.org/x/AgA3
Security Policy: http://wiki.list.org/x/QIA9
Searchable Archives: http://www.mail-archive.com/mailman-users%40python.org/
Unsubscribe: 
https://mail.python.org/mailman/options/mailman-users/archive%40jab.org

Reply via email to