From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-prs-return-9637-listarch-gdb-prs=sources.redhat.com@sourceware.org>
Received: (qmail 24022 invoked by alias); 7 Mar 2011 13:06:21 -0000
Received: (qmail 23997 invoked by uid 22791); 7 Mar 2011 13:06:20 -0000
X-SWARE-Spam-Status: No, hits=-2.9 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; Mon, 07 Mar 2011 13:06:17 +0000
From: "joachim.protze at zih dot tu-dresden.de"
 <sourceware-bugzilla@sourceware.org>
To: gdb-prs@sourceware.org
Subject: [Bug python/12550] New: Strange behavior of doc for gdb.Parameter
X-Bugzilla-Reason: CC
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gdb
X-Bugzilla-Component: python
X-Bugzilla-Keywords: 
X-Bugzilla-Severity: normal
X-Bugzilla-Who: joachim.protze at zih dot tu-dresden.de
X-Bugzilla-Status: NEW
X-Bugzilla-Priority: P2
X-Bugzilla-Assigned-To: unassigned at sourceware dot org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Changed-Fields: 
Message-ID: <bug-12550-4717@http.sourceware.org/bugzilla/>
X-Bugzilla-URL: http://sourceware.org/bugzilla/
Auto-Submitted: auto-generated
Content-Type: text/plain; charset="UTF-8"
MIME-Version: 1.0
Date: Mon, 07 Mar 2011 13:06:00 -0000
Mailing-List: contact gdb-prs-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-prs.sourceware.org>
List-Subscribe: <mailto:gdb-prs-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-prs/>
List-Post: <mailto:gdb-prs@sourceware.org>
List-Help: <mailto:gdb-prs-help@sourceware.org>, <http://sourceware.org/lists.html#faqs>
Sender: gdb-prs-owner@sourceware.org
X-SW-Source: 2011-q1/txt/msg00178.txt.bz2

http://sourceware.org/bugzilla/show_bug.cgi?id=12550

           Summary: Strange behavior of doc for gdb.Parameter
           Product: gdb
           Version: HEAD
            Status: NEW
          Severity: normal
          Priority: P2
         Component: python
        AssignedTo: unassigned@sourceware.org
        ReportedBy: joachim.protze@zih.tu-dresden.de


(gdb) python
>class mynewparameter(gdb.Parameter):
>#  "01234567890123456789"
>  def __init__(self):
>#    self.set_doc="01234567890123456789"
>    self.show_doc="01234567890123456789"
>    super(mynewparameter, self).__init__('mynewparameter',
>         gdb.COMMAND_DATA, gdb.PARAM_UINTEGER)
>    self.value = 20
>mynewparameter()
>end
(gdb) show mynewparameter
567890123456789 is 20.
(gdb) help set mynewparameter
This command is not documented.
This command is not documented.

- for show_doc the first 5 character are skipped
- "help set parameter-name" evaluates both: the set_doc and the __doc__ string.
If it is not set, "This command is not documented." appears - otherwise the
corresponding string is printed. 


For c&p:

python
class mynewparameter(gdb.Parameter):
  "01234567890123456789"
  def __init__(self):
    self.set_doc="01234567890123456789"
    self.show_doc="01234567890123456789"
    super(mynewparameter, self).__init__('mynewparameter',
         gdb.COMMAND_DATA, gdb.PARAM_UINTEGER)
    self.value = 20
mynewparameter()
end
show mynewparameter
help set mynewparameter

-- 
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.