caml-list - the Caml user's mailing list
 help / color / mirror / Atom feed
From: Pietro Abate <Pietro.Abate@pps.jussieu.fr>
To: caml-list@yquem.inria.fr
Subject: Re: [Caml-list] A question about the ocaml man page
Date: Mon, 23 Jun 2008 15:25:38 +0200	[thread overview]
Message-ID: <20080623132538.GB24153@uranium.pps.jussieu.fr> (raw)
In-Reply-To: <D74FC91376084BEBA2CE776CDB3F4578@countertenor>

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


  reply	other threads:[~2008-06-23 13:25 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-06-18  8:14 bill yan
2008-06-18 10:21 ` [Caml-list] " Florent Monnier
2008-06-18 12:07   ` David Allsopp
2008-06-23 13:25     ` Pietro Abate [this message]
2008-06-20 16:30 ` Richard Jones
2008-06-22 13:28   ` Stefano Zacchiroli
2008-06-23  9:08     ` Sylvain Le Gall
2008-06-23 11:59     ` [Caml-list] " Nicolas Pouillard
2008-06-23 12:50       ` Stefano Zacchiroli
2008-06-23 13:14         ` Nicolas Pouillard

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=20080623132538.GB24153@uranium.pps.jussieu.fr \
    --to=pietro.abate@pps.jussieu.fr \
    --cc=caml-list@yquem.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).