Re: Re: peardoc2

From: Date: Fri, 17 Jan 2003 16:37:31 +0000
Subject: Re: Re: peardoc2
References: 1 2  Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-289@lists.php.net to get a copy of this message
On Thu Jan 16, 2003 at 09:5849PM +0100, Thomas Schöfbeck wrote: > - Just some suggestions, since pear and the doc will grow: > - I'd use also .cvsignore for the result-files (e.g. configure as a > result of configure.in), so that "global" committers don't commit > accidentially these files and produce so much unnecessary > cvs-traffic. Feel free to do this once you have enough karma. > - I'd also integrate the 'make-pearweb.sh' in the makefile.in make-pearweb.sh isn't needed by the php.net infrastructure and I added it for testing purpose only. I think we can remove it instead of integrating it into the makefile. > - You've mentioned in the docs the "phpdoc-tools"-dir for win-users > like in the phpdoc-group, but configure.in doesn't check for the > php.bat there. So I'suggest to eighter document that the arg > --with-php... has to be provided, or implement this check like in > the phpdoc-group (works fine there), and document the needed bat-file. Feel free to do this. > - Translations: My experience from phpdoc shows, that we invest MUCH > more time for the maintenance of the translated files than for the > transl. itself. So the question is if there would be a tool similar > to phpdoc's 'revcheck' useful. Imo the translations are in a messy situation right now: All of them are *very* incomplete and not up-to-date anymore. Apart from that they all need to be changed to the new structure once peardoc2 will be used. Perhaps we could integrate revcheck during this transition phase. Anyways, feel free to do it :-). -- - Martin Martin Jansen http://martinjansen.com/

« previous php.pear.doc (#289) next »