From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14887 invoked by alias); 30 Sep 2012 07:51:50 -0000 Received: (qmail 14875 invoked by uid 22791); 30 Sep 2012 07:51:49 -0000 X-SWARE-Spam-Status: No, hits=-4.3 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,SPF_SOFTFAIL X-Spam-Check-By: sourceware.org Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sun, 30 Sep 2012 07:51:43 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0MB500N00KFI1700@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Sun, 30 Sep 2012 09:51:21 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MB500MB4KHKZ720@a-mtaout22.012.net.il>; Sun, 30 Sep 2012 09:51:20 +0200 (IST) Date: Sun, 30 Sep 2012 07:51:00 -0000 From: Eli Zaretskii Subject: Re: [Bug win32/14529] Make gdb capable of JIT-debugging on W32 In-reply-to: <50674CCF.9020800@gmail.com> To: LRN Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83ipawdk3n.fsf@gnu.org> References: <503E575D.1000608@gmail.com> <83y5kvp0za.fsf@gnu.org> <5040DA38.2070802@gmail.com> <504F7E31.10306@redhat.com> <504F818B.6090104@gmail.com> <504F8297.5090507@redhat.com> <5066EC9B.4000409@gmail.com> <838vbtf07z.fsf@gnu.org> <50674CCF.9020800@gmail.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2012-09/txt/msg00710.txt.bz2 > Date: Sat, 29 Sep 2012 23:32:31 +0400 > From: LRN > > > First, please use "MS-Windows" instead of "W32". > OK, although it might not be technically correct. I have no idea > whether ReactOS implements this debugging facility or not, but if it > does, then it is not right to name it "MS-Windows", since ReactOS is > neither MS, nor Windows. > I usually use "W32", because most of the time doing something with > WinAPI means interacting with Win32 subsystem, which, as i've > mentioned above, [is not/will not be] implemented exclusively by Windows. > Now, since GNU folks frown upon "win" in Win32, and naming it Woe32 > sounds weird to me, i just use "W32". W32 is not an acronym known to users. We can use "Windows API", if you think this is more accurate. > +@kindex signal-event > +@item signal-event @var{id} > +This command signals an event with user-provided @var{id}. Used to resume ^^ Please use 2 spaces between sentences. > +To use it, create or edit the following keys in > +@code{HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug} and/or > +@code{HKLM\SOFTWARE\Wow6432Node\Microsoft\Windows NT\CurrentVersion\AeDebug} > +(for x86_64 versions): > + > +@itemize @minus > +@item > +Debugger (REG_SZ) "Debugger" should be in @code{}. > - a command to launch the debugger. Suggested command is: ^ Three dashes here, "---", so that in print there will be a nice em-dash character. One dash is typeset as a minus sign, not what you wanted. > + -ex "attach %ld" -ex "signal-event %ld" > +-ex "c" The command should be in @code, and it should use @var for something the user should substitute. Like this: Suggested command: @code{@var{absolute-file-name-of-gdb.exe} -ex "attach %ld" -ex "signal-event %ld" -ex "continue"}. > +First %ld will be replaced by process ID, second %ld will be replaced by ID > +of the event that blocks the crashing process, waiting for debugger to attach. Please put the %ld in @code{}. > +@item > +Auto (REG_SZ) - either @code{1} or @code{0}. @code{1} will make the system run "Auto" should be in @code{}. > +debugger specified by Debugger key automatically, @code{0} will cause a dialog > +box with "OK" and "Cancel" buttons to appear, which allows the user to either > +terminate crashing process (OK) or debug it (Cancel). Please use ``OK'' and ``Cancel'', not double quotes, for better looks in print. The documentation patch is OK with those changes. Thanks.