nanogui: Nano-X API Manual
Subject:
Re: Nano-X API Manual
From:
Alan Cox ####@####.####
Date:
20 Mar 2000 21:13:32 -0000
Message-Id: <E12X9K1-0003ZO-00@the-village.bc.nu>
> I'll definetly second that Greg... HTML is the way to go. I'd be very
> inclined to document what I'm working on right now if it were in
> HTML..., but I don't want to spend time learning a whole new
> "language" (cough, cough) to write docs. (Docs aren't sexy..., but
> they're required if you want to go anywhere..., make it easy for
> programmers to make those docs, and it's a win-win)
HTML isnt suitable for documentation. It has no indexing, no chapters, no
page numbering. Its a very crude mark up language for web pages. A flawed
one at that.
DocBook took me about 20 minutes to pick up just using an example
document
basically
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[]>
<book>
<bookinfo>
<title>My Book</title>
</bookinfo>
<toc></toc>
<chapter title="id">
<title>My Chapter Foo</title>
<para>
blah blah
</para>
(times n)
</chapter>
</book>
There that was hard..
