From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82])
	by walapai.inria.fr (8.13.6/8.13.6) with ESMTP id pBNH1v5E014880
	for <caml-list@sympa-roc.inria.fr>; Fri, 23 Dec 2011 18:01:57 +0100
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: Av8EADOz9E7VuiYS/2dsb2JhbABDhD9QpyiBBYFyAQEFDBdWEAkCGgImAgIsKwaID6YKkT4TgRyJSoEWBKc3
X-IronPort-AV: E=Sophos;i="4.71,400,1320620400"; 
   d="scan'208";a="136639542"
Received: from solaria.dimino.org ([213.186.38.18])
  by mail1-smtp-roc.national.inria.fr with ESMTP/TLS/ADH-AES256-SHA; 23 Dec 2011 18:01:52 +0100
Received: from arrakis (localhost.localdomain [127.0.0.1])
	by solaria.dimino.org (Postfix) with ESMTP id A03FA8003C;
	Fri, 23 Dec 2011 18:01:51 +0100 (CET)
Received: by arrakis (Postfix, from userid 1000)
	id 2692A11F187; Fri, 23 Dec 2011 18:01:51 +0100 (CET)
Message-ID: <1324659711.22841.41.camel@arrakis>
From: =?ISO-8859-1?Q?J=E9r=E9mie?= Dimino <jeremie@dimino.org>
To: Gabriel Scherer <gabriel.scherer@gmail.com>
Cc: Mihamina Rakotomandimby <mihamina@rktmb.org>, caml-list@inria.fr
Date: Fri, 23 Dec 2011 18:01:51 +0100
In-Reply-To: <CAPFanBENrfvHh_qid07akjhm0KgSz4RAKCwwcGFhZvp08O2q2A@mail.gmail.com>
References: 
	<CAL2=XadH_LBiXOtH3R1uVzyL_Kvy7-VMKn42pmntu__xFNt-fQ@mail.gmail.com>
	 <4EF43609.6040609@rktmb.org>
	 <CAPFanBENrfvHh_qid07akjhm0KgSz4RAKCwwcGFhZvp08O2q2A@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
X-Mailer: Evolution 3.0.3-3+b1 
Mime-Version: 1.0
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by walapai.inria.fr id pBNH1v5E014880
Subject: Re: [Caml-list] Format OCaml Code

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