On Sun, 2003-02-02 at 01:02, Grant Jacobs wrote:
At 10:36 PM -0600 1/2/03, Richard D. Jackson wrote:
Spot on. Much like that layout from Web Design in a Nutshell as I was referring to earlier (I did post that didn't I?),
No I don't recall seeing it.
See below.
but with all the bits together in one place. I still prefer the layout of WDIN as it interates with written documentation well (not the automatic annotations, but the long hand description of the aims and use of some feature which usually written after the fact). Also it means there are short appendices with just the least needed to remind you of the keywords, parameters, etc.
do you have a URL for example output of WDIN?
= Web Design in a Nutshell, in cause you didn't guess!
Oh you are talking about a book! No I did not know or guess. Which version is it. The local used book store may have a copy I can take a look at.
<big snip>
But this style is good for an on-line doc.
FWIW, I'm interested in that particular layout as its how I intend to doc my APIs.
Grant
It is allso the way I want to do mine as well.
By this, I meant the way the WDIN book is laid out. Which, since you haven't seen it, can't be what you're referring to...! So, err, what _are_ you referring to?!
I was refering to the link into the javadoc's
But I think for a first pass I will take a harder look at what frank wants as it is not nearly as complicated as what we want.
I get that impression too.
But one of the things I really need to do is look over what texinfo can or can'nt do. Because I would really like my online doc's and printed docs to have a simular layout if possible.
Personally I'm going to leave texinfo out of mine, but that has to do with the fact that I want it to tie in with my little computer language project and I don't want that too dependent on other things as if it even come to completion it'll have to stand on its own two little feet ;-)
Then what are you going to use for hard copy production?
Richard