[lxc-devel] Putting man pages on website?

Rob Landley rlandley at parallels.com
Wed Feb 9 03:34:24 UTC 2011


On 02/07/2011 09:28 AM, Daniel Lezcano wrote:
> On 02/07/2011 04:19 PM, Rob Landley wrote:
>> Does the makefile's man page generation stuff do html files?  Because if
>> so I'd like put them on the web page, it's some of the best
>> documentation on the thing and people trying to learn about containers
>> can't find it via google...
> 
> Yep, you can use docbook2html on the sgml files located in the doc
> directory of lxc's source tree.

I ran docbook2html lxc-cgroup.sgml.in and it said:

Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#html
Working on: /home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:26:63:W:
cannot generate system identifier for public text "-//Davenport//DTD
DocBook V3.0//EN"
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:30:0:E:
reference to entity "REFENTRY" for which no system identifier could be
generated
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:26:0: entity
was defined here
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:30:0:E: DTD
did not contain element declaration for document type name
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:32:9:E:
element "REFENTRY" undefined
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:34:10:E:
element "DOCINFO" undefined
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:34:16:E:
element "DATE" undefined
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:36:10:E:
element "REFMETA" undefined
openjade:/home/landley/parallels/lxc/doc/lxc-cgroup.sgml.in:37:18:E:
element "REFENTRYTITLE" undefined

And rather a lot more.

Is this normal?  Should I be adding more arguments so it can find something?

Rob




More information about the lxc-devel mailing list