From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26740 invoked by alias); 8 Jan 2004 22:48:56 -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 26732 invoked from network); 8 Jan 2004 22:48:54 -0000 Received: from unknown (HELO mail-out4.apple.com) (17.254.13.23) by sources.redhat.com with SMTP; 8 Jan 2004 22:48:54 -0000 Received: from mailgate3.apple.com (a17-128-100-68.apple.com [17.128.100.68]) by mail-out4.apple.com (8.12.10/8.12.9) with ESMTP id i08Mmrjp001851 for ; Thu, 8 Jan 2004 14:48:53 -0800 (PST) Received: from relay3.apple.com (relay3.apple.com) by mailgate3.apple.com (Content Technologies SMTPRS 4.3.6) with ESMTP id ; Thu, 8 Jan 2004 14:48:53 -0800 Received: from [17.201.22.21] (moleja.apple.com [17.201.22.21]) by relay3.apple.com (8.12.10/8.12.9) with ESMTP id i08MmpIE006722; Thu, 8 Jan 2004 22:48:51 GMT In-Reply-To: References: <9E0EDFCC-40B1-11D8-B832-000393D457E2@apple.com> <44249748-416D-11D8-9715-000393D457E2@apple.com> Mime-Version: 1.0 (Apple Message framework v609) Content-Type: multipart/mixed; boundary=Apple-Mail-1-805632208 Message-Id: Cc: gdb-patches@sources.redhat.com From: Jason Molenda Subject: [Committed] RFA/doc: couple of small Obj-C documentation tweaks Date: Thu, 08 Jan 2004 22:48:00 -0000 To: Eli Zaretskii X-SW-Source: 2004-01/txt/msg00221.txt.bz2 --Apple-Mail-1-805632208 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII; format=flowed Content-length: 62 Thanks for the additional comments, Eli. I checked this in: --Apple-Mail-1-805632208 Content-Transfer-Encoding: 7bit Content-Type: text/plain; x-unix-mode=0644; name="pa.txt" Content-Disposition: attachment; filename=pa.txt Content-length: 4868 2004-01-08 Jason Molenda Eli Zaretskii * gdb.texinfo: Update copyright. (Objective-C): "methodName" typeo fixed. Add @code/@var markup around names, as appropriate. Minor syntax cleanup of _NSPrintForDebugger explanation. Two spaces after periods. GDBN used instead of lit. "gdb". Index entries added for print-object and _NSPrintForDebugger. @noindent added in one spot. Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.185 retrieving revision 1.186 diff -u -p -r1.185 -r1.186 --- gdb.texinfo 28 Oct 2003 22:04:47 -0000 1.185 +++ gdb.texinfo 8 Jan 2004 22:47:00 -0000 1.186 @@ -1,6 +1,6 @@ \input texinfo @c -*-texinfo-*- @c Copyright 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, -@c 1999, 2000, 2001, 2002, 2003 +@c 1999, 2000, 2001, 2002, 2003, 2004 @c Free Software Foundation, Inc. @c @c %**start of header @@ -52,7 +52,7 @@ This is the @value{EDITION} Edition, of Version @value{GDBVN}. Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998,@* - 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc. + 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -115,7 +115,7 @@ This file describes @value{GDBN}, the @s This is the @value{EDITION} Edition, for @value{GDBN} Version @value{GDBVN}. -Copyright (C) 1988-2003 Free Software Foundation, Inc. +Copyright (C) 1988-2004 Free Software Foundation, Inc. @menu * Summary:: Summary of @value{GDBN} @@ -8482,12 +8482,13 @@ A fully qualified Objective-C method nam -[@var{Class} @var{methodName}] @end smallexample -where the minus sign is used to indicate an instance method and a plus -sign (not shown) is used to indicate a class method. The -class name @var{Class} and method name @var{methoName} are enclosed in -brackets, similar to the way messages are specified in Objective-C source -code. For example, to set a breakpoint at the @code{create} instance method of -class @code{Fruit} in the program currently being debugged, enter: +where the minus sign is used to indicate an instance method and a +plus sign (not shown) is used to indicate a class method. The class +name @var{Class} and method name @var{methodName} are enclosed in +brackets, similar to the way messages are specified in Objective-C +source code. For example, to set a breakpoint at the @code{create} +instance method of class @code{Fruit} in the program currently being +debugged, enter: @smallexample break -[Fruit create] @@ -8500,10 +8501,10 @@ enter: list +[NSText initialize] @end smallexample -In the current version of GDB, the plus or minus sign is required. In -future versions of GDB, the plus or minus sign will be optional, but you -can use it to narrow the search. It is also possible to specify just a -method name: +In the current version of @value{GDBN}, the plus or minus sign is +required. In future versions of @value{GDBN}, the plus or minus +sign will be optional, but you can use it to narrow the search. It +is also possible to specify just a method name: @smallexample break create @@ -8524,20 +8525,24 @@ clear -[NSWindow makeKeyAndOrderFront:] @node The Print Command with Objective-C @subsubsection The Print Command With Objective-C +@kindex print-object +@kindex po @r{(@code{print-object})} -The print command has also been extended to accept methods. For example: +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. +@cindex @code{_NSPrintForDebugger}, and printing Objective-C objects +@noindent +will tell @value{GDBN} to send the @code{hash} message to @var{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, @code{_NSPrintForDebugger}, defined. @node Modula-2, , Objective-C, Support @subsection Modula-2 --Apple-Mail-1-805632208--