Dear Maintainer,

The version of /usr/share/xml/docbook/stylesheet/docbook5/db4-upgrade.xsl
supplied in the docbook5-xml package is five years out of date, and the
out of date version contains translation errors which undermine the utility
of the file. A newer version is available from the Docbook repository at

https://sourceforge.net/p/docbook/code/HEAD/tree/trunk/docbook/relaxng/tools/db4-upgrade.xsl

If you upgrade this file, I suggest also checking other files in the Docbook
repository as it's possible it is not the only one that's out of date.

Sid appears to be using the same docbook5-xml package as wheezy, so
the problem is not fixed simply by using the package from sid.

   * What led up to the situation?

Translating Docbook 4 -> Docbook 5 documents using db4-upgrade.xsl

   * What exactly did you do (or not do) that was effective (or
     ineffective)?

xsltproc /usr/share/xml/docbook/stylesheet/docbook5/db4-upgrade.xsl
<docbook4file.xml>

   * What was the outcome of this action?

File was translated to Docbook 5, but was missing elements of the original
Docbook 4 source.
Specifically, <title> elements in <refsynopsisdiv> were dropped.

   * What outcome did you expect instead?

All elements of Docbook 4 source to be translated to the comparable Docbook 5
source.