Re: [Caml-list] Documentation tools

["Stefan Monnier" <monnier+lists.caml/news/@rum.cs.yale.edu>]

>>>>> "Xavier" == Xavier Leroy <Xavier.Leroy@inria.fr> writes:
> Man pages and Info documents are also useful in some situations,
> although in the long run I believe they will disappear and be replaced
> by HTML or XML documentation.

After all these years, HTML still has no good support for navigating
with the keyboard, for full-document searches or for indices.
The best you can get is "look for the `next' button" or "reach for
the search engine" or "look around for the `index' page".

These are the three reasons why I find `info' much more usable.
Maybe `info' will be replaced in the long run, but I have the distinct
impression that this run is going to be mighty long.

> Still, if the tool could output these formats without too much efforts,
> that would be nice.

Given the added functionality offered by Info (even though many people
dislike Info browsers and even though HTML also offers its own added
functionality) I think that Info (or better yet TeXinfo) output shouldn't
be left in the "would be nice" category.


	Stefan "who also finds SGML tags overly verbose"
-------------------
To unsubscribe, mail caml-list-request@inria.fr.  Archives: http://caml.inria.fr