From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-22243-listarch-gdb-patches=sources.redhat.com@sources.redhat.com>
Received: (qmail 704 invoked by alias); 4 Feb 2003 06:08:06 -0000
Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sources.redhat.com>
List-Archive: <http://sources.redhat.com/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sources.redhat.com>
List-Help: <mailto:gdb-patches-help@sources.redhat.com>, <http://sources.redhat.com/ml/#faqs>
Sender: gdb-patches-owner@sources.redhat.com
Received: (qmail 689 invoked from network); 4 Feb 2003 06:08:05 -0000
Received: from unknown (HELO is.elta.co.il) (199.203.121.2)
  by 172.16.49.205 with SMTP; 4 Feb 2003 06:08:05 -0000
Received: from is (is [199.203.121.2])
	by is.elta.co.il (8.9.3/8.8.8) with SMTP id IAA23272;
	Tue, 4 Feb 2003 08:06:26 +0200 (IST)
Date: Tue, 04 Feb 2003 06:08:00 -0000
From: Eli Zaretskii <eliz@is.elta.co.il>
X-Sender: eliz@is
To: David Carlton <carlton@math.stanford.edu>
cc: Michael Elizabeth Chastain <mec@shout.net>, drow@mvista.com,
        gdb-patches@sources.redhat.com
Subject: Re: [rfa/doc] correct info about best C++ compilers/debug formats
In-Reply-To: <ro1lm0x86kv.fsf@jackfruit.Stanford.EDU>
Message-ID: <Pine.SUN.3.91.1030204075821.22830D-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
X-SW-Source: 2003-02/txt/msg00101.txt.bz2


On 3 Feb 2003, David Carlton wrote:

> I can go with that.  I would assume that the + in 'stabs+' has to be
> set off by @t, but TeXinfo doesn't complain; Eli, should I use stabs+
> or stabs@t{+}?

I'd use either @code{stabs+} or simply stabs+.  The @t{++} in C@t{++} is 
a kind of gimmick, since the C++ language name is a pun on a C operator
++.  There's no such pun in stabs+, AFAIK.

> Here's the next version of the patch; it changes this sentence, and
> also replaces some uses of @samp{-gsomething} by @option{-gsomething},
> which I assume is preferred.

Yes, @option is preferred once we require Texinfo 4.0 or later.

> +an effective form for debug info.  See @ref{Debugging Options,,Options
> +for Debugging Your Program or @sc{gnu} CC, gcc.info, Using @sc{gnu} CC},
> +for more information.

It is better to use "@xref{something}" rather than "See @ref{something}" 
at the beginning of a sentence, since the result will look better in Info 
(a single "*Note" instead of a "See *note").  Sorry I didn't catch this 
earlier.

Otherwise, this is fine; please go ahead and commit it.

Thanks.