From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 7207 invoked by alias); 23 Jun 2006 18:06:39 -0000 Received: (qmail 7194 invoked by uid 22791); 23 Jun 2006 18:06:37 -0000 X-Spam-Check-By: sourceware.org Received: from nitzan.inter.net.il (HELO nitzan.inter.net.il) (192.114.186.20) by sourceware.org (qpsmtpd/0.31) with ESMTP; Fri, 23 Jun 2006 18:06:35 +0000 Received: from HOME-C4E4A596F7 (IGLD-84-228-250-14.inter.net.il [84.228.250.14]) by nitzan.inter.net.il (MOS 3.7.3-GA) with ESMTP id DVO70880 (AUTH halo1); Fri, 23 Jun 2006 21:06:29 +0300 (IDT) Date: Fri, 23 Jun 2006 20:10:00 -0000 Message-Id: From: Eli Zaretskii To: gdb@sourceware.org CC: karl@freefriends.org In-reply-to: <20060623171419.GA28992@nevyn.them.org> (message from Daniel Jacobowitz on Fri, 23 Jun 2006 13:14:19 -0400) Subject: Re: [remote] RFC: Replace qPart with qXfer Reply-to: Eli Zaretskii References: <20060622031731.GA26722@nevyn.them.org> <20060623171419.GA28992@nevyn.them.org> X-IsSubscribed: yes Mailing-List: contact gdb-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sourceware.org X-SW-Source: 2006-06/txt/msg00192.txt.bz2 > Date: Fri, 23 Jun 2006 13:14:19 -0400 > From: Daniel Jacobowitz > > > > Access the target's "auxiliary vector". *Note auxiliary > > > vector: OS Information, and see *Note read-aux-vector-packet: > > ^^^ > > This "see" is redundant. I suspect you used "see @ref"; if so, just > > drop the "see" part. > > [...] > > Confused. The example in the Texinfo manual suggests "see @ref", and > says that you shouldn't just drop it, because e.g. "in *Note" is > considered awkward. The first example in the "ref" node indeed might sound as if it says that, but the truth is that @ref exists precisely _because_ you might sometimes want to omit the "see" part, because the sentence structure requires that. You shouldn't read that section of the Texinfo manual too literally, all it wants to say is that you should think about how the sentence will sound in both Info and printed versions, and apply your best judgement as to what would be best. Karl, is it possible to reword that section along these lines (provided that you agree with my reasoning, of course)? In the case in point, I think that "*Note FOO, and *Note BAR" sounds better than with the extra "see". You don't have the "in" in your sentence, so the situation is different from what the manual describes. In the printed version, removing "see" will produce this: See Section X.YZ [OS Information], page 123, and Section A.BC [read-aux-vector], page 456. which is okay, I think.