This is actually not my suggestion, I just would like to summarize those things that come up, and present a possible implementation method for a distributed build system. I must point out that I am not ultimately convinced that such a system would work.
1) End goal: get manuals in different languages onto the php.net server and mirror sites (for online viewing and for downloading)
2) Current method: build on a central server, which does not work because of the lot of stuff need to be done for different languages
3) Already solved: CHM building is done on Derick's machine automatically
4) Possible solution:
- define http/ftp addresses, where the translation teams put
their manuals (for online viewing and for downloads) - poll these addresses frequently from the rsync machine, and
get the actual files if needed, replacing the older ones on
the rsync server - if the new files are bogus (ie will print out PHP errors),
than that is the responsibility of the translation team to
fix the error, and update the files at their server, which
will be picked up by the polling sometime later - one server can generate multiple languages, therefore if some
lanaguage maintainers are unable to build their own manuals,
some server can help out- one language should not be built by more then one server
- new manuals should only be built, if they are need to be built,
to save bandwidth for rsync.php.netIt may seem that this is the only way to make manuals build again. Why I am not satisfied with this is that
- translation teams get more work this way, while we generally try to
come up with methods to ease the translators life, not to
complicate it
- livedocs will come sometime (that time may not be too close though),
and we need to forget this whole stuff then (or at least most of it)
- I don't know if there may be issues with incoming bandwidth on
rsync.php.net...Still it would probably be good to discuss this, maybe you can convince me that this solution would work. It would be good to approach systems@ with a detailed description of what we would like to do, if something useable seems to appear...
Goba
-- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
