From mboxrd@z Thu Jan 1 00:00:00 1970 Received: (from majordomo@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id IAA09221; Fri, 8 Jun 2001 08:49:25 +0200 (MET DST) X-Authentication-Warning: pauillac.inria.fr: majordomo set sender to owner-caml-list@pauillac.inria.fr using -f Received: (from weis@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id IAA09719 for caml-list@pauillac.inria.fr; Fri, 8 Jun 2001 08:49:24 +0200 (MET DST) Received: from nez-perce.inria.fr (nez-perce.inria.fr [192.93.2.78]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id OAA28942 for ; Thu, 7 Jun 2001 14:22:23 +0200 (MET DST) Received: from adsl-gw.nexgen-private (ABoulogne-102-1-4-141.abo.wanadoo.fr [193.253.182.141]) by nez-perce.inria.fr (8.11.1/8.10.0) with ESMTP id f57CMM922286 for ; Thu, 7 Jun 2001 14:22:23 +0200 (MET DST) Received: from fabien (fabien.nexgen-private [192.9.200.110]) by adsl-gw.nexgen-private (8.10.2/8.10.2) with SMTP id f57CAYJ11985 for ; Thu, 7 Jun 2001 14:10:35 +0200 Message-ID: <004001c0ef4c$e86833f0$6ec809c0@fabien> From: "FabienFleutot" To: "Caml List" References: <5.1.0.14.0.20010606105508.03bcd550@chasm.org> Subject: Re: [Caml-list] ocaml complexity Date: Thu, 7 Jun 2001 14:25:15 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.00.2919.6700 X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2919.6700 Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk > Perhaps the manual could be restructured to make this clear: Another simpler and faster solution, which could be done without taking time to the ocaml development team, would be to write some sort of "Ocaml user manual's user manual": a small document indicating what parts of the manual are important relative a given purpose, what are the more common beginner mistakes to avoid, and a guide about the order in which the different concepts should be studied. Here is a list of the most common "autonomous Ocaml learner" mistakes I've been faced to, as a former beginner and as an Ocaml evangelist with my friends. We should discuss about that, then write it down in a user manual's manual. Please note that these features are already dicussed in the manual: my purpose is just to concentrate them in a place where they are focused on. This would be my ---unsorted--- hot points list; addition/modifications/removal are obviously welcomed: - The compiler relies on upper|lowercaseness of the words - Use currying for multiple-parameters functions instead of tuples - Use of the fun keyword (it semmes to me the relevant part of the manual has been rewritten between Ocaml 2.04 and 3.00, and the newer version is much clearer). - Don't reinvent hot water, and study at least the List library - When two features have some common points, explain what's common and what are their respective advantages (structures vs. cartesian products, parentheses and begin..end, etc.). Beginners often can't imagine that two different features have a lot of common parts, if it is not clearly set. - Show how many different things can/should be done by pattern matching. - usefulness of .mli files - many other points I've forgotten. I guess that those who have teached ocaml programming in an academic frame will stress some very different points: this would be interesting to compare with. ------------------- Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/ To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr