On Sat, 2003-02-01 at 20:50, Grant Jacobs wrote:
At 8:27 PM -0600 1/2/03, Richard D. Jackson wrote:
On Fri, 2003-01-31 at 23:06, Frank Heckenbach wrote:
<snip> > Take a look at this > http://java.sun.com/j2se/1.4.1/docs/api/index.html > ignore the stuf at the top and scroll down to the section containing the > method documentation. This is the type of format/output I would like to > see the html ouput engine produce for a function/procedure. I wouldn't > mind seeing that type of output on the texinfo side either but I > definatly want it on the html side. Now to do that type of formating > will require that the documenter mark what is what.
Could you please give an exact URL of the page you mean? The URL above contains a frameset with several menus, I'm not sure exactly what to look at.
Sorry about that try this: http://java.sun.com/j2se/1.4.1/docs/api/java/awt/Paint.html And look at the Method Detail section at the bottom. There happens to be only one method for this but it does show what I'm thinking about.
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.
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?
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. 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. Besides I can add the stuff we want later but still have the things that frank wants as well. Also I like some of the ideas he has and adding some features to get fancer output should not be hard if I design it with that in mind from the get go.
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.
Richard