[lxc-devel] Putting man pages on website?

Daniel Lezcano daniel.lezcano at free.fr
Wed Feb 9 08:19:10 UTC 2011

On 02/09/2011 04:34 AM, Rob Landley wrote:
> 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?

I have no problem to generate on Ubuntu lucid and maverick, maybe you 
can generate the man pages within a container ;)
What distro are you using ?

More information about the lxc-devel mailing list