English version
Accueil     À propos     Téléchargement     Ressources     Contactez-nous    

Ce site est rarement mis à jour. Pour les informations les plus récentes, rendez-vous sur le nouveau site OCaml à l'adresse ocaml.org.

Browse thread
[Caml-list] Documentation tools
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: 2001-05-14 (15:46)
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