caml-list - the Caml user's mailing list
 help / color / mirror / Atom feed
From: Nicolas barnier <barnier@recherche.enac.fr>
To: Caml list <caml-list@inria.fr>
Subject: Documentation of the labelled standard library modules
Date: Wed, 14 Mar 2007 11:22:30 +0100	[thread overview]
Message-ID: <45F7CCE6.5040500@recherche.enac.fr> (raw)

Hello,

While teaching OCaml, I often urge my student to refer to the documentation,
especially the standard library section. The table of content of this 
section
used to be quite compact and manageable for beginners, but since the 
introduction
of the labelled versions of some modules, I think this page has become quite
crippled with useless redundancies, and first year students easily get lost
while browsing the manual.

Could it be possible to structure the standard library section so that the
labelled modules would be hidden within a special subsection (at the upper
level or within the same chapter), and not flatly mixed with the core ones ?
With such a structure, it would be easier to teach OCaml without having to
elaborate on the label extension.

Moreover, I don't really understand the special need of the "meta-module"
MoreLabels. Wouldn't it be more consistent to have all labelled modules
named standard_nameLabels at the first level, or all gathered in 
MoreLabels ?
I'm probably missing something historical here...

-- Nicolas


                 reply	other threads:[~2007-03-14 10:22 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=45F7CCE6.5040500@recherche.enac.fr \
    --to=barnier@recherche.enac.fr \
    --cc=caml-list@inria.fr \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).