Sure, Henning...
I detect the same problem in DOC compilation... I'll take a look in Your suggestions and make the necessary changes on the scripts... after that I'll re-send them to You so that You can apply them... ;)
I thing that the issues that You faced, on applying the patch, were due the fact that they use portuguese messages (I 'm just guessing... ;) )
In fact, if any of the other guys in this list could point more of this "general clean-up rules", please, let me know so that I can make scripts to apply than in a more automated way.
Edson
-----Original Message----- From: Henning Westerholt [mailto:henning.westerholt@1und1.de] Sent: quarta-feira, 27 de fevereiro de 2008 11:20 To: openser-docs@lists.openser.org Cc: Edson Subject: Re: [OpenSER-Docs] First Clean-up Patch for Documentation
On Tuesday 26 February 2008, Edson wrote:
I finish the first clean-up of the documentation. It consisted by:
- remove all FAQ and DEVEL files considered empty in content (no content at all or just the default lines);
- remove of the <RevHistory>/</RevHistory> tag (and of course anything Between them);
- remove the comments at the EOF that beginned with "<!-- Keep this element at the end of the file";
The attached file (in ZIP format) is the resulting SVN DIFF file. It was applied over trunk version, revision 3761.
Hi Edson,
i've applied your changes to the svn trunk. There were some issues with the patch on my checkout, so i used the script that you've send me yesterday. ;-)
Anyway, with this changes the module documentation don't build anymore, because the faq and devel files are missing. I guess that should be fixed. :-)
I the header of each files there are the entities defined:
<!ENTITY user SYSTEM "maxfwd_user.sgml">
<!ENTITY devel SYSTEM "maxfwd_devel.sgml">
<!ENTITY faq SYSTEM "maxfwd_faq.sgml">
And on the bottom there included:
&user; &devel; &faq;
For all modules that don't define a own devel file the define and include for that should be removed. And for all files that don't define a own faq file, for the define the new copy on "../../../doc/module_faq.sgml" should be used. This way the empty devel section will be removed from most modules documentation, and the FAQ sections will stays the same. What do you think about this?
There is also a additional issue with the <RevHistory> stuff you removed. This were included in a <chapterinfo></chapterinfo> block. Apparently an empty block like this is not valid, so i think the empty <chapterinfo> must also be removed.
You're quite good with this scripting stuff, perhaps you can take a look?
Thank you,
Henning