[lxc-devel] Building man pages fails

[Daniel Lezcano]

Ciprian Dorin, Craciun wrote:
> 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!)
>   

No problem, it is not obvious there is a bug tracker opened for this 
project.
I hope one day I have the time to make some good documentation for the 
project on the sourceforge website :)

Thanks
  -- Daniel