Globals, Namespaces, and Documentation

[Neil Stevens]

-----BEGIN PGP SIGNED MESSAGE-----
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.

Super.

> 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 qualityassistant.com

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

iD8DBQE/Q/Tcf7mnligQOmERAgOTAJ9xGI9uQTlNMcpAuTHNPZzDlqdwEQCggmNz
qYMoNXggEZowquXYzPZyM3I=
=ivoj
-----END PGP SIGNATURE-----