experimental manual source for advanced translation handling

From: Date: Thu, 21 Jun 2001 09:39:36 +0000
Subject: experimental manual source for advanced translation handling
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969335562@lists.php.net to get a copy of this message
ok, the lists are up again, so lets re-start work i've done some experiments on one of the topics we had discussed here before the list went down you can find the modified source under http://zugeschaut-und-mitgebaut.de/php/phpdoc-ex.tar.gz -------------------------- README ----------------------------- this is an experimental modification of the php manual source all the files in the function directory have been split up in a general part and a subdirectory containing the actual refentries, one function refentry per file this enables configure to insert original english documentation for missing translations on the function level the actual php manual source will only do so on the extension level. this way newly added functions in the english version will not show up in translations until they are actualy translated -> BAD THING (TM) configure isn't very fast on finding out which file to use where while checking for translations, but this could easiely be imporved as soon as we have decided to use this new scheme the xml processing itself is slowed down due to the increased number of file includes, but this effect is almost unmeasurable right now this experimental package has only english original and german translated files i'm not sure yet wether we should follow the way presented here, which would break CVS history a bit (which is not as important for documentation as it is for actual code) or whether it would be better to leave the xml files as they are and have them split up and recombined in the background during the actual built, but that is a different story ... please have a look and tell me what you think about it Hartmut Holzgraefe <hartmut@six.de> -- Hartmut Holzgraefe hartmut@six.de http://www.six.de +49-711-99091-77

« previous php.doc (#969335562) next »