DB4 to DB5 conversion stylesheet

Hi,

 

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:call-template name="emit-message">

    <xsl:with-param name="message">

      <xsl:text>Dropping class attribute from productname</xsl:text>

    </xsl:with-param>

  </xsl:call-template>

  <xsl:copy>

    <xsl:call-template name="copy.attributes">

      <xsl:with-param name="suppress" select="'class'"/>

    </xsl:call-template>

    <xsl:apply-templates/>

  </xsl:copy>

</xsl:template>

 

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 -->

  <remark>

    <xsl:copy-of select="@*"/>

    <xsl:value-of select="."/>

  </remark>

</xsl:template>

 

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.

 

 

Regards,

Alexey.