Nicolas Grilly wrote:
I agree with the idea that documentation of ConTeXt's commands and parameters is rather incomplete.
I'm wondering if it's possible to have a documentation system like Java's Javadoc. We can put comments just before commands definitions and use a little preprocessor written in Perl or Python that parse TeX files in order to build a ConTeXt documentation like the manual titled "ConTeXt commands".
I'm looking forward your opinion about this.
one of the problems with a tex like system is that there is quite some interference, for instance, spacing is related to fonts and height/depth ations and such. This means that it's rather complex to describe some mechanisms independently, take: \framed {\startlines whatever \stoplines} - framed has its own spacing issues, either or not aligned, auto struts, offsets, auto width etc; these can be described (and are in several places) but it takes some playing around to get the picture - startlines in itself has vertical spacing set up - however, in this combination this before/after spacing interferes with auto-struts or take footnotes: due to limitations in tex, footnotes may not be burried too deep in boxes, (has to do with thw way inserts are implemented); so, context has some workarounds which work in most cases, but not always ... sometimes it's not even easy to predict when somethign will work out another example is splitting tables over pages: there are so many boundary conditions that it would take a manual on it sown that's not to say that we should not try to describe it ... you can add for instance comment to the command browser in the wiki Hans