Charles Samuels (charles@kde.org) wrote:
> I apologize for using the D-word, however, I've
> created some, so I think that makes it acceptable.
>
> But first, I was having a little fun kernel-hacking
> the other day, and I had noticed that every time I
> want information on function-X, I have to start
> grepping like hell, and it's even worse when I don't
> know the name of the function. What we needed was an
> API (KPI?) reference.
>
> So I made one.
>
>
> <blink><marquee> http://derkarl.org/kerneldoc/
> </marquee></blink>
> (It seems that 10% of europe can't get that domain:
> 207.44.242.45)
>
> Obviously, it's not complete, in fact, if it were
> any less complete, I could call it the linux
> kernel :)
>
> The _real_ reason I post this message is, of course,
> for help. I'll be more than happy to accept new xml
> documentation files (the bottom of each page
> contains a link to the associated XML file, as an
> example).
>
> PS. I'm not on this mailing list (I'm on plenty,
> don't worry), so I'll be following it on the
> archives.
>
> -Charles
(I'm only quoting your whole message because I'm
cc'ing it to discuss@linuxdoc.org.)
Have you considered writing this as an LDP Guide?
Advantages:
* Harness the incredible power of a virtual army of
LDP volunteers. (Well, a virtual platoon...)
* The docs become print-ready as well.
* DocBook is a standard! Yay standards!
* Use the already-present distribution network the LDP
has in place.
Disadvantages:
* Your formatting looks spiffier than the LDP
stylesheets.
* You'd have to rewrite what you have.
* DocBook is not tailored to your purposes.
* Multiple versions will exist throughout the world.
I believe it's an alternative worth considering. I'd
be willing to convert what you already have to
DocBook.
-adam buchbinder
__________________________________________________
Do You Yahoo!?
Get personalized email addresses from Yahoo! Mail
http://personal.mail.yahoo.com/
-
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/
This archive was generated by hypermail 2b29 : Mon Jul 23 2001 - 21:00:10 EST