From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4177 invoked by alias); 10 Apr 2002 18:14:22 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 4148 invoked from network); 10 Apr 2002 18:14:15 -0000 Received: from unknown (HELO mail-out1.apple.com) (17.254.0.52) by sources.redhat.com with SMTP; 10 Apr 2002 18:14:15 -0000 Received: from mailgate1.apple.com (A17-128-100-225.apple.com [17.128.100.225]) by mail-out1.apple.com (8.11.3/8.11.3) with ESMTP id g3AIEFt22190 for ; Wed, 10 Apr 2002 11:14:15 -0700 (PDT) Received: from scv3.apple.com (scv3.apple.com) by mailgate1.apple.com (Content Technologies SMTPRS 4.2.1) with ESMTP id ; Wed, 10 Apr 2002 11:13:47 -0700 Received: from inghji (inghji.apple.com [17.202.40.220]) by scv3.apple.com (8.11.3/8.11.3) with ESMTP id g3AIEEv25260; Wed, 10 Apr 2002 11:14:14 -0700 (PDT) Date: Wed, 10 Apr 2002 11:14:00 -0000 Subject: Re: add set cp-abi command Content-Type: text/plain; charset=US-ASCII; format=flowed Mime-Version: 1.0 (Apple Message framework v481) Cc: Daniel Jacobowitz , gdb-patches@sources.redhat.com To: Eli Zaretskii From: Jim Ingham In-Reply-To: Message-Id: Content-Transfer-Encoding: 7bit X-SW-Source: 2002-04/txt/msg00408.txt.bz2 On Tuesday, April 9, 2002, at 11:31 PM, Eli Zaretskii wrote: > > On Tue, 9 Apr 2002, Jim Ingham wrote: > >> I got distracted from this for a little while... Here is a final >> version with something in the texi file as well. > > Thanks. Some comments about the doco patch: > >> + @kindex set cp-abi >> + @item set cp-abi >> + @itemx set cp-abi auto >> + Set the C++ ABI that gdb will use to decode C++ objects. The >> default is "auto" >> + which means gdb will assume the gnu-v2 ABI unless it sees symbols >> that >> + look like the gnu-v3 ABI, in which case it will switch to the gnu-v3 >> ABI. With >> + no arguments, list the available C++ ABIs. > > Please explain in a few words what "ABI" means; I don't think Joe Random > C++ User will necessarily know that. A list of possible values one can > use (in addition to "auto") is also something the manual should have. I not sure I agree with this. First off, this "set" section doesn't explain what other similarly obscure terms mean (like "set vtable"). These are expert features, so if you need them presumably you know what they are. Also, the available types are dynamically generated. The doc's tell you how to get the list, so it seems like actually listing the current possible values is just asking for the manual to get out of date... > > (Btw, I think that the built-in documentation of the "set abi" command > could also use a word of explanation of the term "ABI".) > > Please change "auto" to ``auto'' (this looks much prettier in the > printed > version, and is translated into "auto" in the Info output), and please > use C@t{++} instead of C++ (also for aesthetic reasons). > > Finally, we use `@value{GDBN}' instead of just `gdb' throughout the > manual (evidently to allow custom versions of manuals for GDB that is > named differently). Will do. Jim -- Jim Ingham jingham@apple.com Developer Tools - gdb Apple Computer