From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.user/14337 Path: news.gmane.org!not-for-mail From: Richard Riley Newsgroups: gmane.emacs.gnus.user Subject: Re: Error in (info "(gnus)Splitting Mail") Date: Sun, 19 Dec 2010 16:55:58 +0100 Organization: aich tea tea pea dicky riley dot net Message-ID: References: <87fwtwzqm5.fsf@topper.koldfront.dk> <87aak4488w.fsf_-_@gmail.com> <874oa9u9au.fsf@lifelogs.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1292776818 17530 80.91.229.12 (19 Dec 2010 16:40:18 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 19 Dec 2010 16:40:18 +0000 (UTC) To: info-gnus-english@gnu.org Original-X-From: info-gnus-english-bounces+gegu-info-gnus-english=m.gmane.org@gnu.org Sun Dec 19 17:40:14 2010 Return-path: Envelope-to: gegu-info-gnus-english@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PUMIt-0002n5-Mm for gegu-info-gnus-english@m.gmane.org; Sun, 19 Dec 2010 17:40:12 +0100 Original-Received: from localhost ([127.0.0.1]:40928 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PUMIr-0002EQ-Bp for gegu-info-gnus-english@m.gmane.org; Sun, 19 Dec 2010 11:40:09 -0500 Original-Path: usenet.stanford.edu!goblin1!goblin.stu.neva.ru!uio.no!quimby.gnus.org!not-for-mail Original-Newsgroups: gnu.emacs.gnus Original-Lines: 36 Original-NNTP-Posting-Host: 85.183.18.158 Original-X-Trace: quimby.gnus.org 1292774158 19088 85.183.18.158 (19 Dec 2010 15:55:58 GMT) Original-X-Complaints-To: usenet@quimby.gnus.org Original-NNTP-Posting-Date: Sun, 19 Dec 2010 15:55:58 +0000 (UTC) User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.2 (gnu/linux) Original-Xref: usenet.stanford.edu gnu.emacs.gnus:85062 X-BeenThere: info-gnus-english@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Announcements and discussions for GNUS, the GNU Emacs Usenet newsreader \(in English\)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: info-gnus-english-bounces+gegu-info-gnus-english=m.gmane.org@gnu.org Errors-To: info-gnus-english-bounces+gegu-info-gnus-english=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.gnus.user:14337 Archived-At: Štěpán Němec writes: > Ted Zlatanov writes: > >> On Sat, 18 Dec 2010 16:33:47 -0600 Tommy Kelly 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.