[lxc-devel] [ lxc-Bugs-2962063 ] Building man pages fails

[SourceForge.net]

Bugs item #2962063, was opened at 2010-03-02 19:32
Message generated for change (Comment added) made by ciprian_craciun
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=826303&aid=2962063&group_id=163076

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: liblxc
Group: None
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Daniel Lezcano (dlezcano)
Assigned to: Nobody/Anonymous (nobody)
Summary: Building man pages fails

Initial Comment:
    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.

----------------------------------------------------------------------

Comment By: Ciprian Dorin Craciun (ciprian_craciun)
Date: 2010-03-09 00:02

Message:
I've fixed the problem above as presented in the following patch (URL to
the changeset on my Gitorious repository):
http://gitorious.org/~ciprian.craciun/lxc/ciprian-craciun-patches/commit/7a6e4fe2cc8fa7ea1c2a1e16a292a896717552b4?diffmode=sidebyside


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=826303&aid=2962063&group_id=163076