From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 13173 invoked by alias); 8 Jan 2004 16:42:24 -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 12996 invoked from network); 8 Jan 2004 16:42:23 -0000 Received: from unknown (HELO monty-python.gnu.org) (199.232.76.173) by sources.redhat.com with SMTP; 8 Jan 2004 16:42:23 -0000 Received: from [207.232.27.5] (helo=WST0054) by monty-python.gnu.org with asmtp (Exim 4.24) id 1AebZM-0004Z4-Fd; Thu, 08 Jan 2004 09:55:32 -0500 Date: Thu, 08 Jan 2004 16:42:00 -0000 Message-Id: From: Eli Zaretskii To: Jason Molenda CC: gdb-patches@sources.redhat.com In-reply-to: <44249748-416D-11D8-9715-000393D457E2@apple.com> (message from Jason Molenda on Wed, 7 Jan 2004 15:57:35 -0800) Subject: Re: RFA/doc: couple of small Obj-C documentation tweaks Reply-to: Eli Zaretskii References: <9E0EDFCC-40B1-11D8-B832-000393D457E2@apple.com> <44249748-416D-11D8-9715-000393D457E2@apple.com> X-SW-Source: 2004-01/txt/msg00209.txt.bz2 > From: Jason Molenda > Date: Wed, 7 Jan 2004 15:57:35 -0800 > > Thanks for spotting the additional corrections. I'm inexperienced with > texinfo so I want to run the patch past you before I commit. Sure, feel free. > makeinfo and texi2html don't give any warnings when processing this > - I believe it to be correct. The patch is okay, except for the following two very minor problems: > +@kindex _NSPrintForDebugger _NSPrintForDebugger is not a command, so @kindex isn't right here. I'd suggest something like this: @cindex @code{_NSPrintForDebugger}, and printing Objective-C objects > +The print command has also been extended to accept methods. For example: > > @smallexample > -print -[object hash] > +print -[@var{object} hash] > @end smallexample > > @cindex print an Objective-C object description > -will tell gdb to send the -hash message to object and print the > -result. Also an additional command has been added, @code{print-object} > -or @code{po} for short, which is meant to print the description of an > -object. However, this command may only work with certain Objective-C > -libraries that have a particular hook function, called > -@code{_NSPrintForDebugger} defined. > +will tell @value{GDBN} to send the @code{hash} message to @var{object} This last line doesn't start a new paragraph, so you need a @noindent (alone on a separate line) immediately before it, like this: @smallexample print -[@var{object} hash] @end smallexample @cindex print an Objective-C object description @noindent will tell @value{GDBN} to send the @code{hash} message to @var{object} This is needed to prevent makeinfo and TeX from indenting the line as if it were a beginning of a paragraph. (Sorry for not catching this when I first read the patch.) Otherwise, please commit the patch. Thanks.