From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Original-To: caml-list@sympa.inria.fr Delivered-To: caml-list@sympa.inria.fr Received: from mail2-relais-roc.national.inria.fr (mail2-relais-roc.national.inria.fr [192.134.164.83]) by sympa.inria.fr (Postfix) with ESMTPS id A1F3F7FB0A for ; Thu, 27 Nov 2014 07:46:16 +0100 (CET) Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of fr.ripault@gmail.com) identity=pra; client-ip=209.85.216.176; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="fr.ripault@gmail.com"; x-sender="fr.ripault@gmail.com"; x-conformance=sidf_compatible Received-SPF: Pass (mail2-smtp-roc.national.inria.fr: domain of fr.ripault@gmail.com designates 209.85.216.176 as permitted sender) identity=mailfrom; client-ip=209.85.216.176; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="fr.ripault@gmail.com"; x-sender="fr.ripault@gmail.com"; x-conformance=sidf_compatible; x-record-type="v=spf1" Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of postmaster@mail-qc0-f176.google.com) identity=helo; client-ip=209.85.216.176; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="fr.ripault@gmail.com"; x-sender="postmaster@mail-qc0-f176.google.com"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AoADAIbHdlTRVdiwlGdsb2JhbABbDoNJXLZ/hCyKT4FshksCgQYHFgEBAQEBEQEBAQEHCwsJEjCEAwEBAwESER0BGxIFBgEDAQsGBQQHGh0CAiIBEQEFAQoSBhMSEIgIAQMJCQ2vWz0xizaBboMMijEKGScDClyFXwEBAQEBAQQBAQEBAQEBARQBBQ6QaQQHgniBVQWFLgaGcIQVhxOHNYF0ky0YKYR2YR4wAYJJAQEB X-IPAS-Result: AoADAIbHdlTRVdiwlGdsb2JhbABbDoNJXLZ/hCyKT4FshksCgQYHFgEBAQEBEQEBAQEHCwsJEjCEAwEBAwESER0BGxIFBgEDAQsGBQQHGh0CAiIBEQEFAQoSBhMSEIgIAQMJCQ2vWz0xizaBboMMijEKGScDClyFXwEBAQEBAQQBAQEBAQEBARQBBQ6QaQQHgniBVQWFLgaGcIQVhxOHNYF0ky0YKYR2YR4wAYJJAQEB X-IronPort-AV: E=Sophos;i="5.07,467,1413237600"; d="scan'208";a="109792719" Received: from mail-qc0-f176.google.com ([209.85.216.176]) by mail2-smtp-roc.national.inria.fr with ESMTP/TLS/RC4-SHA; 27 Nov 2014 07:46:15 +0100 Received: by mail-qc0-f176.google.com with SMTP id i17so3224555qcy.35 for ; Wed, 26 Nov 2014 22:46:14 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=x9IzjMbRliB+/IbnSpDKgngyfp1c9gJBcEFiCLr0Svk=; b=JfO+yB5G3YgmHHXDL7PgRt9ydUsLL1zN1g7LRpU2keq8dYupV7VrYRmbKJ6ndm+X6h fkIR+XcdRJET8krSu6U34a3YWtagOeTYzzP18UTVD2ft7VEGmRUtH5kuuHYEvKi9YqHd 5XBS2Dk8KHaQtlnsaUejV9FKgLxfzkvEGudg5FvmVGwl5mMJwJIyamUoJCFZmvS0uT2d r0Mpq7wD8d5Cfwcd8QPKapbMTnazxZWx3H93EOCG9fDrvpWf2omVBqZilZbnpwwgxKPn 6x4Ix3kPESy4alYVoZnzkAVegl+grffe0wG6RmLZRZjLkERDlg07xA3iGf52axF+3oVM ayRA== X-Received: by 10.229.209.136 with SMTP id gg8mr51457037qcb.16.1417070774680; Wed, 26 Nov 2014 22:46:14 -0800 (PST) MIME-Version: 1.0 Received: by 10.140.39.42 with HTTP; Wed, 26 Nov 2014 22:45:54 -0800 (PST) In-Reply-To: <20141127062001.GA4529@pllab.is.ocha.ac.jp> References: <20141127062001.GA4529@pllab.is.ocha.ac.jp> From: Francois Ripault Date: Wed, 26 Nov 2014 22:45:54 -0800 Message-ID: To: Kenichi Asai Cc: caml-list@inria.fr Content-Type: multipart/alternative; boundary=001a113390cc25a06a0508d180a4 Subject: Re: [Caml-list] OCamlDoc for multiple languages? --001a113390cc25a06a0508d180a4 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Hi, It seems that what you are looking for is defining custom tags ( http://caml.inria.fr/pub/docs/manual-ocaml-400/manual029.html#s:ocamldoc-cu= stom-tags). Defining a generator to handle those tags is also explained in the documentation. Regards, Fran=C3=A7ois On Wed, Nov 26, 2014 at 10:20 PM, Kenichi Asai wrote: > Dear all, > > > One of my students is porting the universe teachpack of Racket into > > OCaml, which enables easy game programming similarly to Racket. > > I am now encouraging her to make the library public... > > One of the issues in making the library public is that the ocamldoc > comments in mli files are written in Japanese. (This is important for > my Japanese students.) What is a good way to provide ocamldoc > comments in multiple languages? I can only think of having many mli > files for each language, like: > > foo.mli.ja for Japanese > foo.mli.en for English > > and make foo.mli as a link to one of them. But ideally, I want to > keep only one mli file with multiple comments and choose one of them > depending on which language's document I want to create. > > Thank you in advance. > > Sincerely, > > -- > Kenichi Asai > > -- > Caml-list mailing list. Subscription management and archives: > https://sympa.inria.fr/sympa/arc/caml-list > Beginner's list: http://groups.yahoo.com/group/ocaml_beginners > Bug reports: http://caml.inria.fr/bin/caml-bugs > --001a113390cc25a06a0508d180a4 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
Hi,

It seems that what you are= looking for is defining custom tags (http://caml.inr= ia.fr/pub/docs/manual-ocaml-400/manual029.html#s:ocamldoc-custom-tags).= Defining a generator to handle those tags is also explained in the documen= tation.

Regards,

Fran=C3=A7ois

On Wed, Nov 26, 2014 at 10:= 20 PM, Kenichi Asai <asai@is.ocha.ac.jp> wrote:
Dear all,

> One of my students is porting the universe teachpack of Racket into
> OCaml, which enables easy game programming similarly to Racket.
> I am now encouraging her to make the library public...

One of the issues in making the library public is that the ocamldoc
comments in mli files are written in Japanese.=C2=A0 (This is important for=
my Japanese students.)=C2=A0 What is a good way to provide ocamldoc
comments in multiple languages?=C2=A0 I can only think of having many mli files for each language, like:

foo.mli.ja=C2=A0 =C2=A0 =C2=A0 for Japanese
foo.mli.en=C2=A0 =C2=A0 =C2=A0 for English

and make foo.mli as a link to one of them.=C2=A0 But ideally, I want to
keep only one mli file with multiple comments and choose one of them
depending on which language's document I want to create.

Thank you in advance.

Sincerely,

--
Kenichi Asai

--
Caml-list mailing list.=C2=A0 Subscription management and archives:
ht= tps://sympa.inria.fr/sympa/arc/caml-list
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
Bug reports: http://caml.inria.fr/bin/caml-bugs

--001a113390cc25a06a0508d180a4--