Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:29057
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain php.net from 85.214.94.56 cause and error)
Date: Thu, 26 Apr 2007 19:47:23 +0200
Reply-To: Marcus Boerger <helly@php.net>
Message-ID: <1377038162.20070426194723@marcus-boerger.de>
To: Antony Dovgal <antony@zend.com>
CC: Gwynne Raskind <gwynne@wanderingknights.org>, internals@lists.php.net
In-Reply-To: <462FD55A.7080809@zend.com>
References: <97180F0D-CB4C-4071-A859-38059C0DD1FF@wanderingknights.org> <Pine.LNX.4.62.0704252131190.1454@localhost> <0DFF3A59-3419-4A25-B907-E0E71FD41360@wanderingknights.org> <462FD093.90402@zend.com> <1168659886.20070426001225@marcus-boerger.de> <462FD55A.7080809@zend.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] Documenting the Zend2 extension API
From: helly@php.net (Marcus Boerger)

Hello Antony,

Thursday, April 26, 2007, 12:25:30 AM, you wrote:

> 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.

Go to: http://www.php.net/~helly/php/ext/spl/
On the left select 'file members'
Then on the top of the main part select 'functions'
That will give you all global functions.

Now, open 'Class Members' on the left
Then on the top of the main part select 'functions'
That will give you a list of all functions,
each with a list of classes/interfaces implementing them

>> 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.

As i said, from doxygen' XML output we can generate any kind of
structure we see fit.

best regards
marcus