From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1490 invoked by alias); 26 Mar 2010 08:50:46 -0000 Received: (qmail 1478 invoked by uid 22791); 26 Mar 2010 08:50:45 -0000 X-SWARE-Spam-Status: No, hits=-0.8 required=5.0 tests=AWL,BAYES_00,RCVD_IN_SORBS_WEB,SPF_SOFTFAIL X-Spam-Check-By: sourceware.org Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 26 Mar 2010 08:50:38 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0KZV00400SJDCJ00@a-mtaout22.012.net.il> for gdb-patches@sources.redhat.com; Fri, 26 Mar 2010 11:50:35 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.127.176.135]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0KZV001BTSKAAC80@a-mtaout22.012.net.il>; Fri, 26 Mar 2010 11:50:35 +0300 (IDT) Date: Fri, 26 Mar 2010 08:50:00 -0000 From: Eli Zaretskii Subject: Re: [MI tracepoints 9/9] documentation In-reply-to: <201003261108.45867.vladimir@codesourcery.com> To: Vladimir Prus Cc: stan@codesourcery.com, tromey@redhat.com, gdb-patches@sources.redhat.com Reply-to: Eli Zaretskii Message-id: <838w9fh3fm.fsf@gnu.org> References: <201003141204.12015.vladimir@codesourcery.com> <4BABA779.4060803@codesourcery.com> <83d3ysgprv.fsf@gnu.org> <201003261108.45867.vladimir@codesourcery.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2010-03/txt/msg00873.txt.bz2 > From: Vladimir Prus > Date: Fri, 26 Mar 2010 11:08:45 +0300 > Cc: Stan Shebs , > tromey@redhat.com, > gdb-patches@sources.redhat.com > > On Thursday 25 March 2010 22:33:24 Eli Zaretskii wrote: > > > > Date: Thu, 25 Mar 2010 11:12:09 -0700 > > > From: Stan Shebs > > > CC: Eli Zaretskii , tromey@redhat.com, > > > gdb-patches@sources.redhat.com > > > > > > > Is comma actually required per english gramamar, or this is > > > > texinfo quirk? > > > > > > > It's a little of both actually. :-) > > > > Right. But mostly, it's a Texinfo quirk. > > Thanks for clarifying. I've checked in the below. Thank you. Just to explain a bit further, the reason for this Texinfo requirement is that otherwise the Info browser will be unable to find the end of hyperlinks produced from an @xref with more than one argument. Info file is mostly an ASCII file, so it sometimes needs to use punctuation for this purpose. For example, this Texinfo source: @xref{Define, dont-repeat} produces this in Info: *Note dont-repeat: Define It should be clear now that without some special, known in advance, character after "Define", an Info browser would not know where the hyperlink ends. "Define" is the name of a node that this hyperlink references, so the Info browser _must_ deduce it reliably. Info uses a comma or a period for this purpose because these leave the sentence grammatically correct. That is why `makeinfo' bitches at you when you don't put a period or a comma after the right brace of an @xref.