GNOME Bugzilla – Bug 108295
Search and completion are inconsistant
Last modified: 2005-10-04 20:28:28 UTC
In my devhelp books I have the following entries: "GtkWidget.hide" (from gtkmm) "struct GtkWidget" (from gtk+) If I type into the search box "GtkWi" I can see both entries. However, the moment I add 'd' GCompletion kicks in and completes to "GtkWidget.", thus hiding "struct GtkWidget".
Not sure how this should be solved. Except from making the Gtk+ book have "GtkWidget" without "struct" in front (which I think it should anyway). Would probably be nice to be able to have: <function name="GtkWidget" type="struct" link="..."/> <function name="GtkTreViewMode" type="enum" link="..."/> <function name="gtk_tree_select_item" type="function" link="..."/> instead. (Man I hate the <function> tag, should have been <keyword>). If we have it like this we can show a little icon depending type of keyword instead of it being part of the name. Would this be possible James?
James. any comments on this one?
Sorry about not commenting on this. The names in the function list are simply the titles of the <refsect2> elements in the Docbook source. The two ways to fix this would be to alter the generated docbook to use different titles (not sure if this is desirable), or hack devhelp.xsl to try and munge the titles a bit.
There is a bug about improving the gtk-doc file format here: http://bugzilla.gnome.org/show_bug.cgi?id=310542.
Wouldn't it make sense to strip known prefixes anyway from the keyword list, like struct, union, etc? I think they are only present actually for misformatted code (missing separate typedefs for structs for example).
Richard, agreed.
I've committed a change that does that, so I'm closing this bug. Improving the devhelp format is discussed in http://bugzilla.gnome.org/show_bug.cgi?id=310542.