Messages in this thread | | | Date | Sat, 19 Jul 2003 17:25:32 +1000 | From | Michael Still <> | Subject | Re: [PATCH] docbook: Added support for generating man files |
| |
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 > > # IGNORE. > 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.
Cheers, Mikal
--
Michael Still (mikal@stillhq.com) | Stage 1: Steal underpants http://www.stillhq.com | 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 majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
| |