[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-core-devel
Subject:    Re: doxygen docs on developer.kde.org
From:       Neil Stevens <neil () qualityassistant ! com>
Date:       2003-04-09 1:34:03
[Download RAW message or body]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Tuesday April 08, 2003 01:15, Scott Wheeler wrote:
> Is there any reason to not switch our default doc format over to
> Doxygen? 

Does/can Doxygen make docs for classes and methods without comments yet?  
Can it make globals browsable yet?  Those are the only two issues I've had 
with the Doxygen docs.

It's really annoying to read docs for a class but have to also go read the 
source to see methods that are missing.  It's also unfortunate to have 
classes missing in the class lists becuase nobody added docs to them yet.

Also, docs for common functions like i18n, locate, and the Icon loader are 
pretty important.  With the kdoc output, there's a nice Globals link to 
get access to all of them.

- -- 
Neil Stevens - neil@qualityassistant.com
"The shepherd drives the wolf from the sheep's throat, for which the
sheep thanks the shepherd as a liberator, while the wolf denounces him
for the same act as the destroyer of liberty." -- Abraham Lincoln
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (GNU/Linux)

iD8DBQE+k3iPf7mnligQOmERAkn3AJ9+dvfps9Oyr+XRwjt8tH6UgulqFwCfcR5h
fx6mFMPNX+mh6qiNt1B3oTg=
=1PnB
-----END PGP SIGNATURE-----


[prev in list] [next in list] [prev in thread] [next in thread]