Re: Automatic documentation generation for the Romanian language

2008/11/10 Hannes Magnusson <hannes.magnusson@gmail.com>: > On Mon, Nov 10, 2008 at 08:50, Simion Onea <simionea@gmail.com> wrote: > >> What is the correct way of inserting a note in the file >> "appendices/license.xml"? > > Should that file really be manipulated, or even translated? > Messing around with license and copyright stuff scares me. > > -Hannes > Hannes, I agree. But have you noticed that after marking-up the license using DocBook it had been changed, which is not very well? Please compare http://docs.php.net/manual/en/cc.license.php with http://creativecommons.org/licenses/by/3.0/legalcode . While the second license has all the sections and sub-sections numbered (using letters and roman numbers), in our manual we have all the sub-sections bullet-ed. It is a bit of a problem, because throughout the license you will find references to Section 3(b), Section 8(f), etc. I think any lawyer will point out this drawback. I propose to mark-up the license using only <para> and <simpara>'s and manually numbering all the sections and sub-sections accordingly. Regards, Simion.