Re: [PATCH] docbook: Added support for generating man files

From: Michael Still (
Date: Sat Jul 19 2003 - 02:25:32 EST

On Sat, 19 Jul 2003, Andries Brouwer wrote:

> On Sat, Jul 19, 2003 at 12:47:31PM +1000, Michael Still wrote:
> You do this in two steps: first construct an sgml document, then invoke
> docbook2man.

Which is what I currently do.

> So, first you have to figure out what the proper docbook markup is
> for such material. According to me it is <docinfo>...</docinfo>,
> to be placed inside <refentry> before <refmeta>.
> So you do that - example script fragments appended below.

I tried this...

> Next, the docbook2man stage. My presently installed docbook2man says
> sgml('<DOCINFO>', sub { push_output('nul'); });
> sgml('</DOCINFO>', sub { pop_output(); });
> That is, it does not produce any output for a docinfo section.

...and hit this. Another option is that we could ship a tweaked version of
docbook2man with the kernel sources, and call that copy. That could then
turn docinfo's into comments -- this was what I was getting at with my
previous message.

> In the meantime I do not worry too much about this missing copyright.

Okie, that's fair enough.

> By the way, you start copying at <legalnotice>, but I consider that
> the least interesting part. The fact that these docs were written
> by Alan Cox is much more interesting. In other words, it might be
> a good idea to enlarge this <docinfo> section a bit.

Cool. I like your comments. I've got people coming over for dinner
tonight, but I'll see what I can do about whipping up a new patch.



Michael Still ( | Stage 1: Steal underpants | Stage 2: ???? UTC + 10 | Stage 3: Profit

- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to More majordomo info at Please read the FAQ at

This archive was generated by hypermail 2b29 : Wed Jul 23 2003 - 22:00:37 EST