Re: [PHP-DOC] #18403 [Opn->Fbk]: changable directive information (ini_set) From: Philip Olson (philip <email protected>)
Date: 01/20/03

[snip]
> > Well, as we talked about this in the past, those
> > files are not used at
> > all, they are just exist... Maybe some script uses
> > one of them, I cannot
> > remember, but actually they have no use.
>
> Yep, mostly I look at the status.txt and the
> funcsummary.txt to see what new functions have been
> introduced in the source, and to see which ones have
> yet to be documented. Something like that is useful
> for writing documentation, but an XML solution like
> the one you mention below would be nice too.
>
> > We talked
> > at that particular
> > March PHP meeting about having an XML format instead
> > provided for
> > download at php.net/download-docs for IDEs to use...
> > I already have a
> > method to generate that (using XSLT) so this would
> > be the first thing to
> > use xsltproc and not jade ;)) So it would also be
> > nice to start
> > experimenting with xslt without affecting the
> > current system too much...
>
> Sure thing. If that can also generate the summaries
> from the source, in such a way as to be make starting
> up a new doc easy, that would be great indeed. Should
> not be too difficult to cruft together a regex to
> generate some skeletons for the undocumented
> functions, it is just the time that is needed to
> invest to create the code (which regretably will be in
> short supply for me).

The functable module in CVS essentially generates
all the needed information (this is the base that
zend.com/phpfunc/ uses). This generates every function
in the source including the no documentation list.

Also we have /scripts/make_proto.php which generates
skeleton documentation for a new extension which
includes documentation for every function in the
extension. It also adds the &warn.undocumented.func;
entity.

These two beasts are a base for this megabeast you
guys speak of. I am not the person for this job :)

On a related note, Ilia is creating a script to
compare prototypes from php4 source and the proto
in phpdoc.

Regards,
Philip 

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php