[lxc-devel] Putting man pages on website?

[Trent W. Buck]

Rob Landley <rlandley at parallels.com> writes:

> 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...

docbook-xml?