[lxc-devel] Building man pages fails

[Ciprian Dorin, Craciun]

On Tue, Mar 2, 2010 at 7:11 PM, Ciprian Dorin, Craciun
<ciprian.craciun at gmail.com> wrote:
>    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.


    Ups... Didn't knew about the bug tracker... :)
    Next time I'll add the bug my self. (Thanks Daniel!)