From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail3-relais-sop.national.inria.fr (mail3-relais-sop.national.inria.fr [192.134.164.104]) by sympa.inria.fr (Postfix) with ESMTPS id 18EFD7FA8B for ; Wed, 11 Mar 2015 02:34:26 +0100 (CET) Received-SPF: None (mail3-smtp-sop.national.inria.fr: no sender authenticity information available from domain of jeansaintremy@yahoo.com) identity=pra; client-ip=98.139.213.154; receiver=mail3-smtp-sop.national.inria.fr; envelope-from="jeansaintremy@yahoo.com"; x-sender="jeansaintremy@yahoo.com"; x-conformance=sidf_compatible Received-SPF: Pass (mail3-smtp-sop.national.inria.fr: domain of jeansaintremy@yahoo.com designates 98.139.213.154 as permitted sender) identity=mailfrom; client-ip=98.139.213.154; receiver=mail3-smtp-sop.national.inria.fr; envelope-from="jeansaintremy@yahoo.com"; x-sender="jeansaintremy@yahoo.com"; x-conformance=sidf_compatible; x-record-type="v=spf1" Received-SPF: None (mail3-smtp-sop.national.inria.fr: no sender authenticity information available from domain of postmaster@nm9-vm0.bullet.mail.bf1.yahoo.com) identity=helo; client-ip=98.139.213.154; receiver=mail3-smtp-sop.national.inria.fr; envelope-from="jeansaintremy@yahoo.com"; x-sender="postmaster@nm9-vm0.bullet.mail.bf1.yahoo.com"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0ClAADpmv9UlJrVi2JcggY9gW8Mgn6wLY0UiFmBMAdNAQEBAQEBEAEBAQEHCwsJEjCEIRgIFQE5FQkBJBkCMQEOAQYMDIgtAQECEZtDj0qBawSCc4FxjmgBIwMBIwOFMgEBAQEGAQEBAQEBARUGDAIBj0ICgyGBRQWEd4NwkQ0Ghm8fZIswT4QRb4JDAQEB X-IPAS-Result: A0ClAADpmv9UlJrVi2JcggY9gW8Mgn6wLY0UiFmBMAdNAQEBAQEBEAEBAQEHCwsJEjCEIRgIFQE5FQkBJBkCMQEOAQYMDIgtAQECEZtDj0qBawSCc4FxjmgBIwMBIwOFMgEBAQEGAQEBAQEBARUGDAIBj0ICgyGBRQWEd4NwkQ0Ghm8fZIswT4QRb4JDAQEB X-IronPort-AV: E=Sophos;i="5.11,378,1422918000"; d="scan'208,217";a="102839444" Received: from nm9-vm0.bullet.mail.bf1.yahoo.com ([98.139.213.154]) by mail3-smtp-sop.national.inria.fr with ESMTP/TLS/RC4-SHA; 11 Mar 2015 02:34:24 +0100 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1426037662; bh=sBHI26cnXHAL6HqVU/zw1MXlo8PJae9x8WbIEHQFwWE=; h=Date:From:Reply-To:To:Subject:From:Subject; b=Pq4dqbB79zITEQLiqGgr8RWvkEqxR/elQl/RBZGOSE7VSqCdf6/LANF/tehENsFyjGU5SgMSZrLR83JdnVqrHuB5rT4vnCv+8jc++pXl6G/LfDkZQZ9yyHuEo8esjHoJheu6q1iFQp7iXLfLueIJfVRlILoMx6AXF9/GCl0gLEFZXuSupRT6QBNGL2IAVvP7kVMCZDHZ97JFAfjbaYfprdhI8Ppy9pSLHmDEuST0o0qHkaGo0k/psbF4gHJhPnj0FEl1jP45i+3+30UjX9Q9duiRn1DOUds4LwSxT7oEZl8O/dy03XEf2V67JuPI3CWtOrfqi2ldoLhb+0mJNaQ8qg== Received: from [98.139.214.32] by nm9.bullet.mail.bf1.yahoo.com with NNFMP; 11 Mar 2015 01:34:22 -0000 Received: from [98.139.212.193] by tm15.bullet.mail.bf1.yahoo.com with NNFMP; 11 Mar 2015 01:34:22 -0000 Received: from [127.0.0.1] by omp1002.mail.bf1.yahoo.com with NNFMP; 11 Mar 2015 01:34:22 -0000 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 755027.90257.bm@omp1002.mail.bf1.yahoo.com X-YMail-OSG: gjL8m.AVM1nvLOAw5zTcsfgvbJboNpq838AmdeduUANUxbv3Xq5WEcnRtcEiLGY 2Trl3dHrVp75nIcfuHqX5W0PXSuq_F2SRlR9UN1TgweySPyzbTvo.ugyrgxHBF3hSWnqb4M6iFIY nXSTcJ7jLh2DIxl35vtpmjz3FuRjDKLLS4j7o5UyhPwgKCCA3w_uzy7wXrnc1vnqvfVVa0agYZ7r wZ057WSOPFv5kpTm_4MwVvDU4sKamlOkp1vFWreeMnA_mRDMsmOxVU5ARyG.FZBcsLcusZgsS8.X UYjbs_nmzLQyCL3t8.zW6Ndw0t9UYHUz89Mrcb087f4mgR2W9WD8bqvlIjFBYjCpUzTTTPAER6uE Voh4MAUd_hvsd05NWfr8mNmHbqxdUF4E.rTgnr4TWqF_kNm_9TTJrNvvuj3F0H9TK4_FvSJCe_M3 TuqyAe5wDhaIUEAT0C.pICcZcZO1ZoRX96jD3So1KCo7pQ7hGqTMNer6ttRFxaJn0ueGJcWHOdhR hSldmTysoaAzMV0bjgow- Received: by 66.196.81.117; Wed, 11 Mar 2015 01:34:22 +0000 Date: Wed, 11 Mar 2015 01:34:21 +0000 (UTC) From: Jean Saint-Remy Reply-To: Jean Saint-Remy To: OCaml Mailing List Message-ID: <946009894.3251241.1426037661902.JavaMail.yahoo@mail.yahoo.com> MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_3251240_858801929.1426037661899" Subject: [Caml-list] what is the proper way to write a help system in ocaml ------=_Part_3251240_858801929.1426037661899 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Bonjour mon ami, Maybe this subject is off the topic of writing good ocaml code. Even Real World Ocaml does not seem to devote a single paragraph to the topic of developing a good end-user help system. The ocaml manual is an excellent example of self-documenting code. But I've most enjoyed reading Lucas Saiu code base in the project called Marionnet. There building a virtual network is no simple task. Without a good help system even the most abitious program is as useless as tits on a boar. In Marionnet there are seperate texi files that explain how to build and how to configure a virtual network lab. Would you say this is a better approach than using .chm help system in a program like Microsoft excel? Thank you ------=_Part_3251240_858801929.1426037661899 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
Bonjo= ur mon ami,
Maybe this = subject is off the topic of writing good ocaml code. Even Real World Ocaml = does not seem to devote a single paragraph to the topic of developing a goo= d end-user help system. The ocaml manual is an excellent example of self-do= cumenting code. But I've most enjoyed reading Lucas Saiu code base in the p= roject called Marionnet. There building a virtual network is no simple task= . Without a good help system even the most abitious program is as useless a= s tits on a boar. In Marionnet there are seperate texi files that explain h= ow to build and how to configure a virtual network lab. Would you say this = is a better approach than using .chm help system in a program like Microsof= t excel?

Thank you
= ------=_Part_3251240_858801929.1426037661899--