> > No, it does not to me. It means that translators need to have access to
> > the php4/ cvs module, which is something I'm very against.
>
> Agreed.. The default messages stay in the source code and
> are easily reachable for the developer.
>
> (That is something I very much dislike about the current
> phpdoc organization. Every time I want to change something
> in the main English documentation, I need to hunt around for
> remote, well-hidden xml files. The docs were more
> up-to-date, if these files were easier to access.)
Please explain this a little more with a few specific
examples. And please write the phpdoc list with these
concerns. Maybe the structure can be further explained
in the doc HOWTO. Sometimes I find going to the URL of
the manual page helps figure out the location:
www.php.net/manual/en/language.variables.predefined.php
en/language/variables.xml
www.php.net/manual/en/tokens.php
en/appendices/tokens.xml (note it's in appendix in manual)
Finding functions and extension information is easy since the
big change about seven months ago, for example:
www.php.net/manual/en/function.{functionname}.xml
en/reference/{extensionname}/functions/{functionname}.xml
www.php.net/manual/en/ref.{extensionname}.php
en/reference/{extensionname}/reference.xml
Adding functions is simple, just go into the appropriate
extensions function directory and add the xml file. On
a related note, the change/split that happened awhile back:
Old: en/functions/{extension}.xml
New: en/reference/{extension}/functions/{function}.xml
/ini.xml
/reference.xml
/constants.xml
/functions.xml (autogenerated)
Don't edit functions.xml as it's an autogenerated list. Also
note that the Old files are still in CVS for historical and
archival purposes (the changelogs).
It does take a little getting used to but let's discuss it
a little so php-dev people will feel more comfortable. It
now seems intuitive to me although it's not perfect and
changes are still in progress. For example finding some
of the configuration directives can be difficult...
Regards,
Philip
--
PHP Development Mailing List <http://www.php.net/>
To unsubscribe, visit: http://www.php.net/unsub.php
