From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.1.3 (2006-06-01) on yquem.inria.fr X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=none autolearn=disabled version=3.1.3 X-Original-To: caml-list@yquem.inria.fr Delivered-To: caml-list@yquem.inria.fr Received: from mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82]) by yquem.inria.fr (Postfix) with ESMTP id 25049BBAF for ; Mon, 23 Jun 2008 15:25:40 +0200 (CEST) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AsMAAEhBX0iGnQCBm2dsb2JhbACSbAEBAQEBCAUGCQ+dUA X-IronPort-AV: E=Sophos;i="4.27,690,1204498800"; d="scan'208";a="14289472" Received: from shiva.jussieu.fr ([134.157.0.129]) by mail1-smtp-roc.national.inria.fr with ESMTP; 23 Jun 2008 15:25:39 +0200 Received: from hydrogene.pps.jussieu.fr (hydrogene.pps.jussieu.fr [134.157.168.1]) by shiva.jussieu.fr (8.14.3/jtpda-5.4) with ESMTP id m5NDPdNX061796 for ; Mon, 23 Jun 2008 15:25:39 +0200 (CEST) X-Ids:164 Received: from hydrogene.pps.jussieu.fr (localhost.localdomain [127.0.0.1]) by hydrogene.pps.jussieu.fr (8.13.4/jtpda-5.4) with ESMTP id m5NDPc5D024967 for ; Mon, 23 Jun 2008 15:25:38 +0200 Received: (from abate@localhost) by hydrogene.pps.jussieu.fr (8.13.4/8.13.2/Submit) id m5NDPcid024966 for caml-list@yquem.inria.fr; Mon, 23 Jun 2008 15:25:38 +0200 Date: Mon, 23 Jun 2008 15:25:38 +0200 From: Pietro Abate To: caml-list@yquem.inria.fr Subject: Re: [Caml-list] A question about the ocaml man page Message-ID: <20080623132538.GB24153@uranium.pps.jussieu.fr> References: <4858C3F1.9000009@sun.com> <200806181221.37057.fmonnier@linux-nantes.fr.eu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: GNU/Linux User-Agent: Mutt/1.5.9i X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.0 (shiva.jussieu.fr [134.157.0.164]); Mon, 23 Jun 2008 15:25:39 +0200 (CEST) X-Virus-Scanned: ClamAV 0.93/7417/Tue Jun 10 03:14:29 2008 on shiva.jussieu.fr X-Virus-Status: Clean X-Miltered: at jchkmail2.jussieu.fr with ID 485F8835.001 by Joe's j-chkmail (http : // j-chkmail dot ensmp dot fr)! X-j-chkmail-Enveloppe: 485F8835.001/134.157.168.1/hydrogene.pps.jussieu.fr/hydrogene.pps.jussieu.fr/ X-j-chkmail-Score: MSGID : 485F8835.001 on jchkmail2.jussieu.fr : j-chkmail score : . : R=. U=. O=. B=0.014 -> S=0.014 X-j-chkmail-Status: Ham X-Spam: no; 0.00; ocaml:01 ocaml:01 ocamlduce:01 jocaml:01 0100,:01 usr:01 usr:01 camlp:01 foo:01 foo:01 bug:01 beginner's:01 bug:01 git:98 git:98 Hi, This is not stricly really related with this thread, but I started to re-write the ocaml man pages a while ago and to convert them to docbook . My working repo is here, if you're interesting in helping out. The idea is then to use the same pages to write ocamlduce and jocaml man pages as well... There is still quite a bit of work to do... ciao :) p http://git.debian.org/?p=pkg-ocaml-maint/projects/ocamlman.git;a=summary On Wed, Jun 18, 2008 at 01:07:11PM +0100, David Allsopp wrote: > > > I have just installed the ocaml 3.10.2. I noticed there are 35 > > > executable files for ocaml generated under /usr/local/bin, but only 15 > > > man files for ocaml under /usr/local/man. What about the other > > > executable files under /usr/local/bin? For example, there is no man page > > > for /usr/local/bin/camlp4 command, how do I know how to use this > > > command? Thanks. > > > > You should prefer the HTML manuals rather than the mans. > > The mans are mainly to remind quickly some command line arguments. > > Totally agree, though it's pretty irritating when you find a command in > [/usr/local]/bin, have no idea where it came from[1], and man foo or info > foo both come up with nothing! Even if the man page only pointed the reader > in the direction of the HTML manual, that would be better than nothing, > IMHO. > > Feature request in the bug tracker, perhaps? > > > David > > > [1] The fact that most, if not all, OCaml commands contain "caml" in them is > a good hint in this case, of course! > > _______________________________________________ > Caml-list mailing list. Subscription management: > http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list > Archives: http://caml.inria.fr > Beginner's list: http://groups.yahoo.com/group/ocaml_beginners > Bug reports: http://caml.inria.fr/bin/caml-bugs