From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25268 invoked by alias); 16 Nov 2010 14:49:14 -0000 Received: (qmail 25243 invoked by uid 22791); 16 Nov 2010 14:49:12 -0000 X-SWARE-Spam-Status: No, hits=-2.5 required=5.0 tests=ALL_TRUSTED,AWL,BAYES_00 X-Spam-Check-By: sourceware.org Received: from localhost (HELO sourceware.org) (127.0.0.1) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Tue, 16 Nov 2010 14:49:08 +0000 From: "pedro at codesourcery dot com" To: gdb-prs@sourceware.org Subject: [Bug python/12175] show_doc for gdb.Parameter has strange behaviour X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: gdb X-Bugzilla-Component: python X-Bugzilla-Keywords: X-Bugzilla-Severity: normal X-Bugzilla-Who: pedro at codesourcery dot com X-Bugzilla-Status: ASSIGNED X-Bugzilla-Priority: P2 X-Bugzilla-Assigned-To: pmuldoon at redhat dot com X-Bugzilla-Target-Milestone: --- X-Bugzilla-Changed-Fields: CC Message-ID: In-Reply-To: References: X-Bugzilla-URL: http://sourceware.org/bugzilla/ Auto-Submitted: auto-generated Content-Type: text/plain; charset="UTF-8" MIME-Version: 1.0 Date: Tue, 16 Nov 2010 15:14:00 -0000 Mailing-List: contact gdb-prs-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-prs-owner@sourceware.org X-SW-Source: 2010-q4/txt/msg00136.txt.bz2 http://sourceware.org/bugzilla/show_bug.cgi?id=12175 Pedro Alves changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |pedro at codesourcery dot | |com --- Comment #3 from Pedro Alves 2010-11-16 14:49:03 UTC --- (In reply to comment #2) On Tuesday 16 November 2010 14:32:01, pmuldoon at redhat dot com wrote: > When you "show" a parameter, the show_doc documentation is used and then the > value appended at the end (in this case, "off"). GDB trims off the first five > letters of the show documentations (the "Show") so it can reuse it for both the > help text and the value assignment text. Ditto for the Set. FYI, that's deprecated behavior that is going away at some point. All commands should implement the necessary show-current-state callback so that that fallback does not need to apply. The reason that is broken is that it only works for English... At some point, I'd like to make a pass through all commands in GDB, implement all the missing callbacks, get rid of that fallback code, and put an assertion on place making sure the command implements a show callback. > So the example above "works". > > > The "command is not documented" is printed if either show_doc, set_doc or doc > is not set in the parameter. > > Maybe we need a better explanation in the manual? I've no clue on the Python API, is there a way to implement the "show" callback of a parameter? If not, there should be. If yes, it should be a requirement to implement it, per the rationale I mention above. -- Pedro Alves -- Configure bugmail: http://sourceware.org/bugzilla/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.