On 04/26/2007 02:12 AM, Marcus Boerger wrote:
Doxygen (which seems to be uses by the majority of F/OSS projects)
generates completely unreadable docs.
Every time I look into ICU docs (generated by Doxygen) I get lost for 10
minutes trying to find a function _by name_.
In the same time, other tools do not provide such a wide range of output
formats as available in Doxygen.
Hu? It has a search option if you want.
This one? =)
http://www.icu-project.org/apiref/icu4c/search.php?query=strcat
And it has alphabetical lists for
functions, consts, classes, files, modules, whatever.
Maybe there is something wrong with ICU docs (or with me?), but I can't find
any alphabetical index of functions.
All I can see is a list of functions per file, which is noway convenient.
And if that is not enough we could take it's xml output to feed a database and
provide a
fulltext search on that.
We can also use any of search engines available to search in the result HTML.
But the point is that the docs should be well structured enough so that a
fulltext search would not be required.
--
Wbr,
Antony Dovgal
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
