<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE message PUBLIC
  "-//MLarc//DTD MLarc output files//EN"
  "../../mlarc.dtd"[
  <!ATTLIST message
    listname CDATA #REQUIRED
    title CDATA #REQUIRED
  >
]>

  <?xml-stylesheet href="../../mlarc.xsl" type="text/xsl"?>


<message 
  url="2003/07/a1a7c6869de041c8efae851c6e204f3e"
  from="matthieu.dubuget@libertysurf.fr &lt;matthieu.dubuget@l...&gt;"
  author="matthieu.dubuget@libertysurf.fr"
  date="2003-07-30T06:42:32"
  subject="[Caml-list]  Re:_[Caml-list]_Question/Feature_request_about_Camlidl_andcomments]"
  prev="2003/07/7321c1d7a6a5de7042a617ca2c897309"
  next="2003/07/97a211bbc22b3ff2b25194816b7cc9a7"
  next-in-thread="2003/07/97a211bbc22b3ff2b25194816b7cc9a7"
  prev-thread="2003/07/8a44755359f14232b0fd5889d43037b7"
  next-thread="2003/07/f3a61e56891b607c359fd61cf37538f7"
  root="../../"
  period="month"
  listname="caml-list"
  title="Archives of the Caml mailing list">

<thread subject="[Caml-list]  Re:_[Caml-list]_Question/Feature_request_about_Camlidl_andcomments]">
<msg 
  url="2003/07/a1a7c6869de041c8efae851c6e204f3e"
  from="matthieu.dubuget@libertysurf.fr &lt;matthieu.dubuget@l...&gt;"
  author="matthieu.dubuget@libertysurf.fr"
  date="2003-07-30T06:42:32"
  subject="[Caml-list]  Re:_[Caml-list]_Question/Feature_request_about_Camlidl_andcomments]">
<msg 
  url="2003/07/97a211bbc22b3ff2b25194816b7cc9a7"
  from="BdB &lt;benoit.de-boursetty+caml-list@m...&gt;"
  author="BdB"
  date="2003-07-30T07:57:21"
  subject="RE: [Caml-list] Re: [Caml-list] Question/Feature request about Camlidl andcomments]">
</msg>
</msg>
</thread>

<contents>
&gt;Depending on what you base your ocamldoc generation,
&gt;use either ml or mli. Since i think mli is the best
&gt;place to do it i will use it :

&gt;quote(mli,"(** This is a ocamldoc comment *)");

&gt;int my_function ( [string] const char * msg );

&gt;Simple !

I should have explained in detail what I was trying to do.

I did an attempt to do what you are suggesting. The problem
is that it seems difficult to control where the comments
will appear in the generated mli files.

For example, if I try 
quote(mli,"** This is a module *)"); at the very beginning
of my idl file in order to generate a comment to be
associated with the whole module, the string appears between
types definitions and functions definitions, which is not
what we need to conform to ocamldoc. An other point was that
I wanted to comment also the elements of enums.

I may have the time to look at camlidl source code during my
holidays...

Salutations

Matthieu Dubuget





********** L'ADSL A 20 EUR/MOIS**********
Tiscali propose l'ADSL le moins cher du marché : 20 EUR/mois et le modem ADSL offert ! 
Pour profiter de cette offre exceptionnelle, cliquez ici : http://register.tiscali.fr/adsl/
Offre soumise à conditions.


-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners

</contents>

</message>

