Browse thread
[Caml-list] Documentation tools
[
Home
]
[ Index:
by date
|
by threads
]
[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
| Date: | -- (:) |
| From: | Stefan Monnier <monnier+lists.caml/news/@r...> |
| Subject: | Re: [Caml-list] Documentation tools |
>>>>> "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