docbook writers: please no empty para's

Frerich Raabe raabe at kde.org
Wed Feb 15 14:47:59 GMT 2006


On Wednesday 15 February 2006 15:37, Erik K. Pedersen wrote:
> It would be really nice if the various docbook writers would avoid making
> these
> <para>
> </para>
> With nothing in between. It does not work with the translation system. I
> just had the experience again with the docbook for ksirc, and it takes time
> every time to figure out it is this problem rather than something else.
> Just write <para>
> Not yet written
> </para>
>
> or something like that instead. I used to add those myself, but since we
> started using svn I only have a copy of the documentation checked out, so I
> can't do it.

I can't resist pointing out that this is one of the things the DocBook 
Sanitizer (http://www.englishbreakfastnetwork.org/sanitizer/just-in-time.php) 
checks, for exactly the reasons you describe. Ahem. :-)

- Frerich




More information about the kde-core-devel mailing list