From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <berenger@riken.jp>
X-Original-To: caml-list@sympa.inria.fr
Delivered-To: caml-list@sympa.inria.fr
Received: from mail4-relais-sop.national.inria.fr (mail4-relais-sop.national.inria.fr [192.134.164.105])
	by sympa.inria.fr (Postfix) with ESMTPS id 4610B7EE20
	for <caml-list@sympa.inria.fr>; Thu, 15 Nov 2012 09:31:39 +0100 (CET)
Received-SPF: None (mail4-smtp-sop.national.inria.fr: no sender
  authenticity information available from domain of
  berenger@riken.jp) identity=pra; client-ip=134.160.33.161;
  receiver=mail4-smtp-sop.national.inria.fr;
  envelope-from="berenger@riken.jp";
  x-sender="berenger@riken.jp"; x-conformance=sidf_compatible
Received-SPF: Pass (mail4-smtp-sop.national.inria.fr: domain of
  berenger@riken.jp designates 134.160.33.161 as permitted
  sender) identity=mailfrom; client-ip=134.160.33.161;
  receiver=mail4-smtp-sop.national.inria.fr;
  envelope-from="berenger@riken.jp";
  x-sender="berenger@riken.jp"; x-conformance=sidf_compatible;
  x-record-type="v=spf1"
Received-SPF: Pass (mail4-smtp-sop.national.inria.fr: domain of
  postmaster@postman.riken.jp designates 134.160.33.161 as
  permitted sender) identity=helo; client-ip=134.160.33.161;
  receiver=mail4-smtp-sop.national.inria.fr;
  envelope-from="berenger@riken.jp";
  x-sender="postmaster@postman.riken.jp";
  x-conformance=sidf_compatible; x-record-type="v=spf1"
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: AgQBAHKnpFCGoCGhmWdsb2JhbABEw2wBAQEBAQgLCwcUJ4IeAQEFOEARCxgJFg8JAwIBAgEPNhMGAgEBh3UDD7IzDYlUi0hpgwWDJwOIWItPgVWFa4VHiA8
X-IronPort-AV: E=Sophos;i="4.83,255,1352070000"; 
   d="scan'208";a="162537505"
Received: from postman1.riken.jp (HELO postman.riken.jp) ([134.160.33.161])
  by mail4-smtp-sop.national.inria.fr with ESMTP; 15 Nov 2012 09:31:37 +0100
Received: from postman.riken.jp (postman1.riken.jp [127.0.0.1])
	by postman.riken.jp (Postfix) with SMTP id 8669C32C0190
	for <caml-list@inria.fr>; Thu, 15 Nov 2012 17:31:34 +0900 (JST)
Received: from [172.27.98.103] (rikad98.riken.jp [134.160.214.98])
	by postman.riken.jp (Postfix) with ESMTPA id 6129032A0047
	for <caml-list@inria.fr>; Thu, 15 Nov 2012 17:31:34 +0900 (JST)
Message-ID: <50A4A866.6050604@riken.jp>
Date: Thu, 15 Nov 2012 17:31:34 +0900
From: Francois Berenger <berenger@riken.jp>
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:16.0) Gecko/20121028 Thunderbird/16.0.2
MIME-Version: 1.0
To: caml-list@inria.fr
References: <fa.38rAsBvHd+quECbtcbTH9HW+J6U@ifi.uio.no> <fa.YCrkHurCi6yY5s0Qg1r6uLWNQdY@ifi.uio.no> <fa.oeqp0ymFFL+o76ut/LjBeQhUcjQ@ifi.uio.no> <fa.pEDV80ILnW8x1YQyKuF3NBsK3Kw@ifi.uio.no> <fa.LQofvqHUt8xj1kM1rvmQZF+Z7rw@ifi.uio.no> <838ab953-d33f-42d5-a363-050217c1b883@googlegroups.com>
In-Reply-To: <838ab953-d33f-42d5-a363-050217c1b883@googlegroups.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-PMX-Version: 5.6.0.2009776, Antispam-Engine: 2.7.2.376379, Antispam-Data: 2012.11.15.81818
Subject: Re: [Caml-list] Preferred layout for new packages

On 11/15/2012 05:13 PM, vincent.hugot@gmail.com wrote:
> Hello,
>
>> In my opinion I dislike unit tests in comments, also because you throw
>> away editor support
>
> In the case of qtest2 (iTeML), so far there is syntax highlighting for Emacs (maybe outdated) and Kate.
>
> ... but neither of them is in the repository so far... I'll fix that sometime soon.
>
>
> I for one like the (short-)tests-as-comments approach: being near the function, they serve as short specifications, and being comments, they don't alter the compilation process in the least.

I also like this approach.
Short tests also serve as usage examples.
Also, I like things to be centralised.

Regards,
F.