[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [docbook] DB4 to DB5 conversion stylesheet
Thanks for pointing out these problems. We discussed them in the DocBook Technical Committee meeting today, and concluded that you are correct. The conversion stylesheet will get fixed. If you find any other issues, please let us know.
I am exploring possibility of conversion of our documents from DB4 to DB5 using the db4-upgrade.xsl stylesheet provided at docbook.org. I have a few questions regarding the stuff that the stylesheet drops from DB4 elements.
1. Is there a particular reason why that stylesheet drops @class attribute from <productname/>?
<xsl:template match="productname[@class]" priority="200">
<xsl:text>Dropping class attribute from productname</xsl:text>
<xsl:with-param name="suppress" select="'class'"/>
As far as I can see from TDG5.1, it is perfectly legal in DocBook 5.0: http://www.docbook.org/tdg51/en/html/productname.html
At first I thought this removal is because of some element models changing before the final release of DocBook 5.0 specification (the stylesheet claims conformance to 5.0CR5), but I don't see any productname/remark mentions in the specification change history.
2. Similar question: why all mark-up is removed from inside of the <remark/> element?
<xsl:template match="remark" priority="200">
<!-- get rid of any embedded markup -->
Again, TDG5.1 says most mark-up is allowed in <remark/>: http://www.docbook.org/tdg51/en/html/remark.html
3. Is there a reason why all <title>xxx</title> elements are converted to <info><title>xxx</title></info>? As far as I can see, both are legal in DB5. Is <title> going to be deprecated as a direct child of <sectX/> elements?
We don't use anything but titles on lower level elements (such as sections), so <info> just adds some clutter to the documents.