maemo.org Bugzilla – Bug 6268
The required #include directives are not documented for Hildon
Last modified: 2010-03-15 20:54:08 UTC
You need to
before you can comment on or make changes to this bug.
EXACT STEPS LEADING TO PROBLEM:
1. Browse the Hildon Reference Manual (see URL)
2. Check the documentation e.g. for HildonButton, or likely any other class
The Synopsis should list the required #include directive on the first line, as
is customary in GTK+/Glib documentation
No #include directive is documented. The developer is left guessing which
header is needed, or has to search for this information elsewhere.
EXTRA SOFTWARE INSTALLED:
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:220.127.116.11)
Gecko/20091112 Iceweasel/3.5.5 (like Firefox/3.5.5; Debian-3.5.5-1)
Does this cover all of the Widgets? Or also stuff that is NOT part of the
I'm not sure if I understood your question, but all pages that document
functions should also document which header file is needed to use them. The
same applies for widgets as well as non-widget classes (such as HildonProgram).
For GTK+, Glib and most other G* libraries the headers are specified on the
first line of the Synopsis section, see for example
In libhildon I haven't seen that for any class/widget as far as I remember. The
docs for libhildondesktop on the other hand show the headers, libhildonfm and
libnotify again not. I didn't check all of the other libraries, but likely
there may be others too where this information is missing.
Moving to the proper component.
(In reply to comment #2)
> In libhildon I haven't seen that for any class/widget as far as I remember. The
> docs for libhildondesktop on the other hand show the headers, libhildonfm and
> libnotify again not. I didn't check all of the other libraries, but likely
> there may be others too where this information is missing.
This bug is for libhildon, from what I understand. You'll need to file separate
a separate bug for libhildonfm. libnotify would better do with an upstream
report about this.
Author: Claudio Saavedra <firstname.lastname@example.org>
Date: Wed Nov 25 09:34:40 2009 +0100
Add default includes for gtkdoc-mkdb
Fixes: NB#148188 (The required #include directives are not documented
Fixes: MB#6268 (The required #include directives are not documented
This has been fixed in package
which is part of the internal build version
(Note: 2009 is the year, and the number after is the week.)
A future public update released with the year/week later than this internal
build version will include the fix. (This is not always already the next public
Please verify that this new version fixes the bug by marking this bug report as
VERIFIED after the public update has been released and if you have some time.
To answer popular followup questions:
* Nokia does not announce release dates of public updates in advance.
* There is currently no access to these internal, non-public build versions.
A Brainstorm proposal to change this exists at
(Fix not included in today's 2.2009.51-1 update => updating Version field)
Setting explicit PR1.2 milestone (so it's clearer in which public release the
fix will be available to users).
Sorry for the bugmail noise (you can filter on this message).