caml-list - the Caml user's mailing list
 help / color / mirror / Atom feed
From: "Jérémie Dimino" <jeremie@dimino.org>
To: Gabriel Scherer <gabriel.scherer@gmail.com>
Cc: Mihamina Rakotomandimby <mihamina@rktmb.org>, caml-list@inria.fr
Subject: Re: [Caml-list] Format OCaml Code
Date: Fri, 23 Dec 2011 18:01:51 +0100	[thread overview]
Message-ID: <1324659711.22841.41.camel@arrakis> (raw)
In-Reply-To: <CAPFanBENrfvHh_qid07akjhm0KgSz4RAKCwwcGFhZvp08O2q2A@mail.gmail.com>

Le vendredi 23 décembre 2011 à 09:51 +0100, Gabriel Scherer a écrit :
> Note that piping/redirection `camlp4o file.ml > foo` doesn't work as
> camlp4o sends a marshalled AST by default.
> An issue with camlp4 is that it can sometimes move comments a bit: the
> placement of comments in the reformatted source is approximative *with
> respect to whitespace* (you sometimes have a blank inserted between a
> phrase and the comment). That is not really an issue for the human
> reader, but it tends to confuse `ocamldoc`, which relies on whitespace
> heuristics to know which phrase a comment documents. You should think
> twice if you wish to use both camlp4 and ocamldoc at the same time.

Note that ocamldoc does not use the pretty-printed output of camlp4. It
uses locations in the ast and comments are fetched from the original
file.

Cheers,

-- 
Jérémie



  parent reply	other threads:[~2011-12-23 17:01 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-12-23  7:57 haihao shen
2011-12-23  8:04 ` Mihamina Rakotomandimby
2011-12-23  8:51   ` Gabriel Scherer
2011-12-23 12:27     ` rixed
2011-12-23 12:49       ` Jérémie Dimino
2011-12-23 17:01     ` Jérémie Dimino [this message]
2011-12-24  3:48   ` Francois¡¡Charles Matthieu¡¡Berenger
2011-12-24  8:35 ` Jun Furuse
2011-12-24  9:03   ` haihao shen

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=1324659711.22841.41.camel@arrakis \
    --to=jeremie@dimino.org \
    --cc=caml-list@inria.fr \
    --cc=gabriel.scherer@gmail.com \
    --cc=mihamina@rktmb.org \
    /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).