Re: Re: peardoc2
| From: | Martin Jansen | 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/