[svn-commits] mvanbaak: branch group/appdocsxml r129220 - /team/group/appdocsxml/

[SVN commits to the Digium repositories]

Author: mvanbaak
Date: Tue Jul  8 16:37:04 2008
New Revision: 129220

URL: http://svn.digium.com/view/asterisk?view=rev&rev=129220
Log:
add TODO on how to extract/parse the xml and how to handle
different languages.

Modified:
    team/group/appdocsxml/TODO_appdocsxml

Modified: team/group/appdocsxml/TODO_appdocsxml
URL: http://svn.digium.com/view/asterisk/team/group/appdocsxml/TODO_appdocsxml?view=diff&rev=129220&r1=129219&r2=129220
==============================================================================
--- team/group/appdocsxml/TODO_appdocsxml (original)
+++ team/group/appdocsxml/TODO_appdocsxml Tue Jul  8 16:37:04 2008
@@ -38,6 +38,16 @@
 can be pulled out in a reliable way. Now we have to do that for
 all the Documentation we have already converted.
 
+Only document the applications/functions/etc in english in the sourcecode
+Make the build setup extract those as doc/core-en.xml
+Others can use this file to make localized versions (ex. core-nl.xml)
+The loader should look at the documentation_language setting as it is there now in /etc/asterisk.conf
+and load the correct xml file. If the localised version is not present we should fallback
+to core-en.xml
+One step further is to parse other xml files as well for not-in-tree modules.
+On conflict (two defenitions of the same application in the same language) the core-$lang.xml version should be used.
+If possible, a note should be shown to the user that they should send the differences upstream.
+
 === DONE ===
 
 Possibly, instead of passing NULL, NULL on ast_register_application