dogtail-devel [Bug 537956] New: Many many wrong documentation items about actions

["dogtail (bugzilla.gnome.org)" <bugzilla-daemon bugzilla gnome org>]

If you have any questions why you received this email, please see the text at
the end of this email. Replies to this email are NOT read, please see the text
at the end of this email. You can add comments to this bug at:
  http://bugzilla.gnome.org/show_bug.cgi?id=537956

  dogtail | Framework | Ver: 0.6.1
           Summary: Many many wrong documentation items about actions
           Product: dogtail
           Version: 0.6.1
          Platform: Other
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: Normal
         Component: Framework
        AssignedTo: dogtail-maint gnome bugs
        ReportedBy: ydirson altern org
         QAContact: dogtail-maint gnome bugs
     GNOME version: Unspecified
   GNOME milestone: Unspecified


In fact, the documentation seems to be inconsistent and wrong in some places:

- the Node class doctring says all actions, including eg. "activate" are
available as method calls, which is obviously wrong
- the Node::click() docstring correctly says that what is true for "click" is
not for other actions...

... BUT it says all other actions must be invoked through "doAction", which
apparently does not work.  I was only able to get things work by calling the
action's do() method

... and then that was only after I realized that a Node's "actions" field is
not a list as documented, but a dictionnary, hashed by the action name!


-- 
See http://bugzilla.gnome.org/page.cgi?id=email.html for more info about why you received
this email, why you can't respond via email, how to stop receiving
emails (or reduce the number you receive), and how to contact someone
if you are having problems with the system.

You can add comments to this bug at http://bugzilla.gnome.org/show_bug.cgi?id=537956.