[lxc-devel] Building man pages fails

[Ciprian Dorin, Craciun]

    Hy there!

    I wanted to ask this for some time now, but only today I've made
some time... So...

    My context:
    * ArchLinux (latest);
    * db2x_xsltproc (part of docbook2X 0.8.8) $Revision: 1.5 $ $Date:
2004/08/18 14:21:52 $
    * /usr/bin/docbook2man (part of docbook2X 0.8.8) $Revision: 1.12 $
$Date: 2006/04/14 17:29:04 $
    * I can't find anywhere the `-w` option in `man docbook2man`

    When building the man pages I get the following errors:
~~~~
./autogen.sh
./configure
cd ./doc
make lxc-create.1
~~~~
docbook2man -w lxc-create.sgml
/usr//bin/db2x_xsltproc: Unknown option: w
Try "/usr//bin/db2x_xsltproc --help" for more information.
Unable to recognise encoding of this document at
/usr/share/perl5/vendor_perl/XML/SAX/PurePerl/EncodingDetect.pm line
100.
Document requires an element [Ln: 1, Col: 0]
make: *** [lxc-create.1] Error 9
~~~~

    First fix-up: eliminate the `-w` from the Makefile:
~~~~
make lxc-create.1
~~~~
 cd .. && /bin/sh /home/ciprian/desktop/workbench/lxc/config/missing
--run automake-1.11 --gnu doc/Makefile
 cd .. && /bin/sh ./config.status doc/Makefile
config.status: creating doc/Makefile
docbook2man lxc-create.sgml
lxc-create.sgml:26: parser error : SystemLiteral " or ' expected
<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
                                                               ^
lxc-create.sgml:26: parser error : SYSTEM or PUBLIC, the URI is missing
<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
                                                               ^
lxc-create.sgml:137: parser error : Entity 'seealso' not defined
  &seealso;
           ^
unable to parse lxc-create.sgml
Unable to recognise encoding of this document at
/usr/share/perl5/vendor_perl/XML/SAX/PurePerl/EncodingDetect.pm line
100.
Document requires an element [Ln: 1, Col: 0]
make: *** [lxc-create.1] Error 9
~~~~

    Second fix-up: seems that the problem is fixable by replacing the
following line:
        <!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
    with:
        <!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN"
"/dev/null" [

    (I've reached this solution by putting first "", then it
complained it can not open the file '', thus I've put there
/dev/null).

    Now everything seems Ok.

    Any ideas what is wrong here? My packages? Anything with the doocbook?

    Thanks,
    Ciprian.