After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 323403 - Expander activate signal docs wrong
Expander activate signal docs wrong
Status: RESOLVED FIXED
Product: pygtk
Classification: Bindings
Component: documentation
unspecified
Other All
: Normal normal
: ---
Assigned To: Nobody's working on this now (help wanted and appreciated)
Python bindings maintainers
Depends on:
Blocks:
 
 
Reported: 2005-12-06 21:18 UTC by Murray Cumming
Modified: 2006-07-07 21:52 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Murray Cumming 2005-12-06 21:18:38 UTC
The Expander docs say "The "activate" signal is emitted when the expander is
activated by the user clicking on the expander toggle".
http://www.pygtk.org/pygtk2reference/class-gtkexpander.html#signal-gtkexpander--activate

This is apparently not the recommended way: 
http://mail.gnome.org/archives/gtk-devel-list/2003-June/msg00109.html

(and this is a keybinding signal that applications should almost never be using
anyway.)

The correct method is described in the GTK+ docs:
http://developer.gimp.org/api/2.0/gtk/GtkExpander.html#expander-special-usage
Comment 1 John Finlay 2005-12-06 22:19:30 UTC
The docs describe the behavior of the widget including the Special Usage. The
"activate" signal docs are correct. Are you suggesting that they should also
indicate that that the signal can be emitted when the gtk.Widget.activate()
method is callled? Or is it that you think the signal docs should suggest using
the notify::expanded signal instead of "activate"?
Comment 2 Murray Cumming 2005-12-06 22:33:02 UTC
Ah yes, sorry. I guess that the signal docs should mention the property too, for
people who jump straight to the signals. Is that from the C docs too?
Comment 3 John Finlay 2006-07-07 21:52:42 UTC
	* pygtk-gtkexpander.xml ("activate"): Add note and link about using
	"notify:expanded" instead of activate. #323403 (Murray Cummings)