[lxc-devel] Putting man pages on website?

[Rob Landley]

On 02/09/2011 02:19 AM, Daniel Lezcano wrote:
> 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
...
>>
>> 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 ?

Ubuntu 10.04.1 LTS

Presumably I just need to intall another package, but there's no
documentation about what.  Where does it get this from on your system?

>> cannot generate system identifier for public text "-//Davenport//DTD
>> DocBook V3.0//EN"

I'd guess the rest is fallout from being unable to find the right DTD...

Rob