Hi!
One of the oldest outstanding issues in phpdoc is the install section.
We have decided long ago on moving the install.*.xml files from
phpdoc/chapters to phpdoc/install/*.xml, thus making a folder out the
install prefix. This would enable further improvement on the section,
which is very much needed.
To keep the version history, however we need coordination from someone
with adequate rights on the CVS server to move around and rename the
files without loosing the commit history (shell access needed for this).
Since a few of the translations still have the install.xml megafile,
this needs to be taken care of.
This solution seems to be workable for me:
- move $lang/chapters/install.*.xml files to
$lang/install/*.xml
- if a monolitic $lang/chapters/install.xml file exists,
then move it to $lang/install/index.xml
- otherwise move phpdoc/installpart.xml to
$lang/install/index.xml
This would create a proper entry point for the translations on the
install section, while we can eliminate some of the "exception handling"
code from the configure system, which tries to decide on the type of the
install part, since this would not be needed anymore. Of course
installpart.xml needs some changes afterwards, so the changed paths are
reflected.
Anybody against this solution? Or anybody have better suggestions? If we
can fix this plan, I'll try to coordinate with someone from systems@ to
make the changes to keep the CVS histories.
Goba
