Re: Error in (info "(gnus)Splitting Mail")

[Richard Riley]

Štěpán Němec <stepnem@gmail.com> writes:

> Ted Zlatanov <tzz@lifelogs.com> writes:
>
>> On Sat, 18 Dec 2010 16:33:47 -0600 Tommy Kelly <tommy.kelly@verilab.com> 
>> wrote: 
>>
>> TK> The person who wrote the stuff, understands it in intense
>> TK> detail without the documentation, and therefore has little or no need
>> TK> of the documentation thinks the documentation is more readable as it is.
>>
>> TK> The person who is trying to learn the stuff, and must rely heavily on
>> TK> said documentation thinks the documentation would be more readable with a
>> TK> a minor fix.
>>
>> Štěpán was noting a minor issue: if mail comes from majordomoXcom (any
>> single character) instead of majordomo.com, it will match that splitting
>> rule.  I don't think Štěpán suggested it would make the documentation
>> more readable to fix that.
>
> I think Tommy's and Lars's notion of "readable" is slightly incompatible
> here. In my opinion the error (yes, IMO it _is_ an error) should be
> fixed at least for the reason this whole thread started -- it induced
> major confusion for Tommy, who, upon seeing the unescaped dot, began to
> wonder if there was some magic going on with the fancy splitting rules.
>
> (Yes, it's funny to have discussions about things like this, but not
> having sloppy examples in the docs is precisely the way to prevent such
> discussions.)
>
>   Štěpán

The splitting docs are confusing - issues constantly crop up in #emacs
as well as here and in the nognus mailing list. Possibly more simple
examples would help before they start rolling into what is pretty
advanced elisp where quotes and escaping play an important part.