# HG changeset patch # User diego # Date 1273613112 0 # Node ID 20cee5a646b3f5585e3332752264927ad8197258 # Parent a29b422baba55dc75dbb3e7ef60a234699c6cd89 Merge both XML documentation README files into one. diff -r a29b422baba5 -r 20cee5a646b3 DOCS/xml/README --- a/DOCS/xml/README Tue May 11 21:21:45 2010 +0000 +++ b/DOCS/xml/README Tue May 11 21:25:12 2010 +0000 @@ -73,6 +73,28 @@ wrong, check the Configuration section of the toplevel Makefile and adjust the variables. +The documentation and its translations reside in subdirectories. +When building the documentation, the generated HTML files are +placed in subdirectories of the 'HTML' directory. + +IMPORTANT: Do NOT place sensitive files under 'HTML'! + It is for generated documentation only. + The whole directory tree is wiped out by the Makefile + when running 'make distclean' or 'make clean'. + + +Adding new translations +~~~~~~~~~~~~~~~~~~~~~~~ + +1) Create a new subdirectory and copy the XML files there. main.xml must not be + copied, it is autogenerated. + +2) In each translated file after the tag you must put a note + like , where 2 is the revision of corresponding + English file (see comment at the top of file). + +That's all, in theory. + A few words about SGML catalog files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff -r a29b422baba5 -r 20cee5a646b3 DOCS/xml/README.maintainers --- a/DOCS/xml/README.maintainers Tue May 11 21:21:45 2010 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,21 +0,0 @@ -The documentation and its translations reside in subdirectories. -When building the documentation, the generated HTML files are -placed in subdirectories of the 'HTML' directory. - -IMPORTANT: Do NOT place sensitive files under 'HTML'! - It is for generated documentation only. - The whole directory tree is wiped out by the Makefile - when running 'make distclean' or 'make clean'. - - -Adding new translations -~~~~~~~~~~~~~~~~~~~~~~~ - -1) Create a new subdirectory and copy the XML files there. main.xml must not be - copied, it is autogenerated. - -2) In each translated file after the tag you must put a note - like , where 2 is the revision of corresponding - English file (see comment at the top of file). - -That's all, in theory.