Globals, Namespaces, and Documentation

Neil Stevens neil at
Wed Aug 20 23:23:24 BST 2003

Hash: SHA1

On Wednesday August 20, 2003 12:13, Stephan Kulow wrote:
> On Wednesday 20 August 2003 00:37, Neil Stevens wrote:
> > Second, the list of globals is missing.  I'm scouring the Doxygen
> > docs, but can't find any hints about how to get one.  So unless KDE
> > 3.2 will be adding all the globals like i18n, locate, UserIcon, etc.
> > into a KDE namespace, docs for those important functions disappears.
> >
> > When I think about it, that namespace seems like a good idea for more
> > reasons than just documentation.  Would anyone object to wrapping them
> > all in namespace KDE, adding compatibility usings (to be removed for
> > KDE 4)?
> I guess I don't object against the KDE namespace now that it's there.


> BTW: the doxygen way of documenting such functions are groups that
> relate to classes. After all you don't go and think "what global
> functions can I use", but you go and think "how do I translate within
> KDE" -> i18n

I wonder how Doxygen manages to document C, then.

- -- 
Neil Stevens - neil at

"I'll believe it when I see it." -- George Walker Bush
Version: GnuPG v1.2.1 (FreeBSD)


More information about the kde-core-devel mailing list