From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 27360 invoked by alias); 13 Oct 2011 14:06:38 -0000 Received: (qmail 27352 invoked by uid 22791); 13 Oct 2011 14:06:37 -0000 X-SWARE-Spam-Status: No, hits=-2.1 required=5.0 tests=AWL,BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW X-Spam-Check-By: sourceware.org Received: from mail-vx0-f169.google.com (HELO mail-vx0-f169.google.com) (209.85.220.169) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 13 Oct 2011 14:06:18 +0000 Received: by vcbfk1 with SMTP id fk1so57192vcb.0 for ; Thu, 13 Oct 2011 07:06:17 -0700 (PDT) Received: by 10.220.118.195 with SMTP id w3mr284115vcq.122.1318514777631; Thu, 13 Oct 2011 07:06:17 -0700 (PDT) MIME-Version: 1.0 Received: by 10.220.180.75 with HTTP; Thu, 13 Oct 2011 07:05:56 -0700 (PDT) In-Reply-To: <8339ex2eaf.fsf@gnu.org> References: <8339ex2eaf.fsf@gnu.org> From: Kevin Pouget Date: Thu, 13 Oct 2011 14:06:00 -0000 Message-ID: Subject: Re: [Patch][Python] PR python/13285 Document named constants for frame unwind stop reasons To: Eli Zaretskii Cc: tromey@redhat.com, pmuldoon@redhat.com, gdb-patches@sourceware.org Content-Type: multipart/mixed; boundary=00032555853ef3ab3804af2ea46f 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: 2011-10/txt/msg00393.txt.bz2 --00032555853ef3ab3804af2ea46f Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-length: 1328 On Thu, Oct 13, 2011 at 3:48 PM, Eli Zaretskii wrote: > > > From: Kevin Pouget > > Date: Thu, 13 Oct 2011 14:39:16 +0200 > > Cc: pmuldoon@redhat.com, gdb-patches@sourceware.org > > > > I've prepared a bit of documentation for these named constants, based > > on their comments in the source code. > > Thanks. > > > +@table @code > > +@item gdb.FRAME_UNWIND_NO_REASON > > +No particular reason. > > This begs for some explanation of when this "no-reason" reason will be > seen. =A0Is it true that this value is used when it's NOT impossible to > find more frames? =A0If so, we should say that explicitly. Yes, that's my understanding too. I've changed the sentence to > No particular reason (older frames should be available). I'll commit the patch in an hour, if no one contradicts > > +@end table > > There's no need to make each value a separate @table. =A0You can just > make them all be a single table, like this: > > =A0@table @code > =A0@item foo > =A0Description of foo. > =A0@item bar > =A0Description of bar. > =A0... > =A0@end @table. sorry, I don't know where I got it from ! 2011-10-13 Kevin Pouget PR python/13285 Document named constants for frame unwind stop reasons * gdb.texinfo (Frames In Python): Document gdb.FRAME_UNWIND_* constants. --00032555853ef3ab3804af2ea46f Content-Type: text/x-patch; charset=US-ASCII; name="gdb.texinfo.patch" Content-Disposition: attachment; filename="gdb.texinfo.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: f_gtptl9vc0 Content-length: 2119 ZGlmZiAtLWdpdCBhL2dkYi9kb2MvZ2RiLnRleGluZm8gYi9nZGIvZG9jL2dk Yi50ZXhpbmZvCmluZGV4IGRhMDRlMmUuLjBhYTkwZWIgMTAwNjQ0Ci0tLSBh L2dkYi9kb2MvZ2RiLnRleGluZm8KKysrIGIvZ2RiL2RvYy9nZGIudGV4aW5m bwpAQCAtMjM0MTQsNyArMjM0MTQsMzkgQEAgbmV3ZXN0IGZyYW1lLgogUmV0 dXJuIGFuIGludGVnZXIgcmVwcmVzZW50aW5nIHRoZSByZWFzb24gd2h5IGl0 J3Mgbm90IHBvc3NpYmxlIHRvIGZpbmQKIG1vcmUgZnJhbWVzIHRvd2FyZCB0 aGUgb3V0ZXJtb3N0IGZyYW1lLiAgVXNlCiBAY29kZXtnZGIuZnJhbWVfc3Rv cF9yZWFzb25fc3RyaW5nfSB0byBjb252ZXJ0IHRoZSB2YWx1ZSByZXR1cm5l ZCBieSB0aGlzCi1mdW5jdGlvbiB0byBhIHN0cmluZy4KK2Z1bmN0aW9uIHRv IGEgc3RyaW5nLiBUaGUgdmFsdWUgY2FuIGJlIG9uZSBvZjoKKworQHRhYmxl IEBjb2RlCitAaXRlbSBnZGIuRlJBTUVfVU5XSU5EX05PX1JFQVNPTgorTm8g cGFydGljdWxhciByZWFzb24gKG9sZGVyIGZyYW1lcyBzaG91bGQgYmUgYXZh aWxhYmxlKS4KKworQGl0ZW0gZ2RiLkZSQU1FX1VOV0lORF9OVUxMX0lECitU aGUgcHJldmlvdXMgZnJhbWUncyBhbmFseXplciByZXR1cm5zIGFuIGludmFs aWQgcmVzdWx0LgorCitAaXRlbSBnZGIuRlJBTUVfVU5XSU5EX09VVEVSTU9T VAorVGhpcyBmcmFtZSBpcyB0aGUgb3V0ZXJtb3N0LgorCitAaXRlbSBnZGIu RlJBTUVfVU5XSU5EX1VOQVZBSUxBQkxFCitDYW5ub3QgdW53aW5kIGZ1cnRo ZXIsIGJlY2F1c2UgdGhhdCB3b3VsZCByZXF1aXJlIGtub3dpbmcgdGhlIAor dmFsdWVzIG9mIHJlZ2lzdGVycyBvciBtZW1vcnkgdGhhdCBoYXZlIG5vdCBi ZWVuIGNvbGxlY3RlZC4KKworQGl0ZW0gZ2RiLkZSQU1FX1VOV0lORF9JTk5F Ul9JRAorVGhpcyBmcmFtZSBJRCBsb29rcyBsaWtlIGl0IG91Z2h0IHRvIGJl bG9uZyB0byBhIE5FWFQgZnJhbWUsCitidXQgd2UgZ290IGl0IGZvciBhIFBS RVYgZnJhbWUuICBOb3JtYWxseSwgdGhpcyBpcyBhIHNpZ24gb2YKK3Vud2lu ZGVyIGZhaWx1cmUuICBJdCBjb3VsZCBhbHNvIGluZGljYXRlIHN0YWNrIGNv cnJ1cHRpb24uCisKK0BpdGVtIGdkYi5GUkFNRV9VTldJTkRfU0FNRV9JRAor VGhpcyBmcmFtZSBoYXMgdGhlIHNhbWUgSUQgYXMgdGhlIHByZXZpb3VzIG9u ZS4gIFRoYXQgbWVhbnMKK3RoYXQgdW53aW5kaW5nIGZ1cnRoZXIgd291bGQg YWxtb3N0IGNlcnRhaW5seSBnaXZlIHVzIGFub3RoZXIKK2ZyYW1lIHdpdGgg ZXhhY3RseSB0aGUgc2FtZSBJRCwgc28gYnJlYWsgdGhlIGNoYWluLiAgTm9y bWFsbHksCit0aGlzIGlzIGEgc2lnbiBvZiB1bndpbmRlciBmYWlsdXJlLiAg SXQgY291bGQgYWxzbyBpbmRpY2F0ZQorc3RhY2sgY29ycnVwdGlvbi4KKwor QGl0ZW0gZ2RiLkZSQU1FX1VOV0lORF9OT19TQVZFRF9QQworVGhlIGZyYW1l IHVud2luZGVyIGRpZCBub3QgZmluZCBhbnkgc2F2ZWQgUEMsIGJ1dCB3ZSBu ZWVkZWQKK29uZSB0byB1bndpbmQgZnVydGhlci4KK0BlbmQgdGFibGUKKwog QGVuZCBkZWZ1bgogCiBAZGVmdW4gRnJhbWUucGMgKCkK --00032555853ef3ab3804af2ea46f--