From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 15777 invoked by alias); 1 Jun 2003 16:21:54 -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 15744 invoked from network); 1 Jun 2003 16:21:53 -0000 Received: from unknown (HELO odin.inter.net.il) (192.114.186.10) by sources.redhat.com with SMTP; 1 Jun 2003 16:21:53 -0000 Received: from zaretsky (tony08-233-35.inter.net.il [80.230.233.35] (may be forged)) by odin.inter.net.il (Mirapoint Messaging Server MOS 3.3.3-GR) with ESMTP id BFI15129; Sun, 1 Jun 2003 19:21:42 +0300 (IDT) Date: Sun, 01 Jun 2003 16:21:00 -0000 From: "Eli Zaretskii" To: fedor@doc.com Message-Id: <1190-Sun01Jun2003192231+0300-eliz@elta.co.il> CC: gdb-patches@sources.redhat.com In-reply-to: <3ED97889.30707@doc.com> (message from Adam Fedor on Sat, 31 May 2003 21:52:41 -0600) Subject: Re: [Ping/RFA]: ObjC Documentation Reply-to: Eli Zaretskii References: <3EAF44EE.30301@doc.com> <3ED97889.30707@doc.com> X-SW-Source: 2003-06/txt/msg00021.txt.bz2 > Date: Sat, 31 May 2003 21:52:41 -0600 > From: Adam Fedor > > This patch hasn't been reviewed yet: > > http://sources.redhat.com/ml/gdb-patches/2003-04/msg00542.htm Sorry, my bad; I missed the original message somehow. Here are my comments: +@itemx .m +Objective-C source file This should be "@item .m", not @itemx. @itemx is only used when you have several table items which all share the same text, like this: @item foo @itemx bar @itemx baz Sample items for the same descriptive text. +The following commands have been extended to accept Objective-C method +names as line specifications: + +@itemize +@item @code{clear} +@item @code{break} +@item @code{info line} +@item @code{jump} +@item @code{list} +@end itemize These need index entries for the special syntax of these commands when debugging Objective-C programs. Like this: @kindex clear@r{, and Objective-C} Also, the general form of the extended commands is something I sorely miss in this description. Given the example: +@example +break -[Fruit create] +@end example someone like me who doesn't speak fluent Objective-C is left wondering what is "Fruit" and why do I need the `-' and the brackets. Yes, I know, some of that is explained further down, but a general form of each command early on would both make the esamples more clear and serve as an instant reminder for someone who just needs to see the general rule. Finally, please imagine that you are a user looking up the manual for some specific issues pertinent to these features, and add index entries for any issues users might wish to use to find the text you wrote. With those comments taken care of, the patch is approved. Feel free to ask if something in what I wrote is unclear. Last, but not least: thanks for working on this!