Linux-kernel mailing list archive 2000-15,: Re: devfs - why not ?

# Re: devfs - why not ?

Alan Cox (alan@lxorguk.ukuu.org.uk)
Thu, 13 Apr 2000 02:58:56 +0100 (BST)

- Messages sorted by: [ date ][ thread ][ subject ][ author ]
- Next message: Richard Gooch: "Re: devfs - why not ?"
- Previous message: Alan Cox: "Re: user-mode port 0.19-2.3.99-pre4"
- In reply to: Richard Gooch: "Re: devfs - why not ?"
- Next in thread: Tim Waugh: "Re: devfs - why not ?"
- Reply: Tim Waugh: "Re: devfs - why not ?"
- Reply: Matthias Andree: "Re: inline API documentation formats (was: devfs - why not ?)"

> > the kernel manual semi-automatically
>
> I've been meaning to look at that. It depends on:
>
> - how ugly I find the gdoc/javadoc format :-)

See drivers/net/z85230.c for an example. It is meant to drop into comments
in such a way that its hardly obvious they are 'special' in any way.

> - whether man pages and HTML can be automatically generated.

It'll output man pages, html, tex, pdf, ps, dvi and probably a few more
formats. It turns the pages into DocBook SGML (an SGML markup originally
aimed at technical documentation), from there the tools can make almost
anything of it easily (except ascii, although there are ugly ways to do
that job)

Alan

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu
Please read the FAQ at http://www.tux.org/lkml/

- Next message: Richard Gooch: "Re: devfs - why not ?"
- Previous message: Alan Cox: "Re: user-mode port 0.19-2.3.99-pre4"
- In reply to: Richard Gooch: "Re: devfs - why not ?"
- Next in thread: Tim Waugh: "Re: devfs - why not ?"
- Reply: Tim Waugh: "Re: devfs - why not ?"
- Reply: Matthias Andree: "Re: inline API documentation formats (was: devfs - why not ?)"