nanogui: Nano-X API Manual
Subject:
Re: Nano-X API Manual
From:
####@####.####
Date:
20 Mar 2000 23:05:58 -0000
Message-Id: <20000320152719.A3104@www.easysolutions.net>
Well... that looks fine to me, I suppose I don't really care as long
as it's some sort of SGML DTD type format. I just cringe at the
thought of postscript, and messing with LaTeX. If it can be written
in vi or Emacs I'm on board. (notice the or... enough controversy
with documentation formats already! :>) The DOCBOOK->HTML converters
work quite well anyway, so putting up online docs is no problem...
that I think is important, being able to put the docs up in HTML
format for people to read. How it gets there doesn't matter... if
docbook provides a more organized structure by which to form the
documentation... the so be it.
Shane.
> 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..
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: ####@####.####
> For additional commands, e-mail: ####@####.####
>
