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 q1F8ihPZ001189 for ; Wed, 15 Feb 2012 09:44:44 +0100 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AuoDAPJvO09QDPKFjmdsb2JhbABDn0eRQAEBAQEJCwkJEgUkgXIBAQEEAQEBNzQLDAQLEQECAQIBDSEhBgEUCQQGCAYTCQkJh2QGuUcTiDGDKQUPCxMFCgECEQMFBwMCB4NdKwQFAhABCAKDLwSTDIInixOHVQ X-IronPort-AV: E=Sophos;i="4.73,422,1325458800"; d="scan'208";a="144314461" Received: from smtp11.smtpout.orange.fr (HELO smtp.smtpout.orange.fr) ([80.12.242.133]) by mail1-smtp-roc.national.inria.fr with ESMTP; 15 Feb 2012 09:44:44 +0100 Received: from alcazar ([83.203.200.238]) by mwinf5d46 with ME id a8kh1i013596vkK038kiP5; Wed, 15 Feb 2012 09:44:44 +0100 Date: Wed, 15 Feb 2012 09:44:40 +0100 From: Maxence Guesdon To: Francois Berenger Cc: caml-list@yquem.inria.fr Message-ID: <20120215094440.01705df2@alcazar> In-Reply-To: <4F3B65B9.5010704@riken.jp> References: <4F3B65B9.5010704@riken.jp> X-Mailer: Claws Mail 3.7.9 (GTK+ 2.24.8; x86_64-pc-linux-gnu) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Re: [Caml-list] Fwd: Re: [Batteries-devel] browsing the code while reading the doc Hello, If you provide the .ml files to ocamldoc and use the -keep-code option, generated html pages will give a link on each value to display the corresponding code. Another solution would be to adapt the odoc_literate custom generator you can find here: https://gitorious.org/ocamldoc-generators This generator provide an expand/collpase button for each value, useful when writing doc in a literate programming way. At last, since Dynlink now allows loading native code, ocamldoc now supports loading custom generators compiled to native code, which may be fast enough to use the batteries legacy generator. Hope this helps, Maxence On Wed, 15 Feb 2012 16:58:49 +0900 Francois Berenger wrote: > -------- Original Message -------- > Subject: Re: [Batteries-devel] browsing the code while reading the doc > Date: Wed, 15 Feb 2012 08:47:42 +0100 > From: bluestorm > To: Francois Berenger > CC: batteries-devel@lists.forge.ocamlcore.org > > We delegate documentation production to the standard ocamldoc tool, > which doesn't have this feature, so that is not really in the game > zone of batteries developers. That said, it *could* be possible to > make that feature available without changing ocamldoc upstream, by > implementing it as a custom documentation formatter -- ocamldoc has a > flexible architecture in this regard. > http://caml.inria.fr/pub/docs/manual-ocaml/manual029.html#toc120 > > Xavier Clerc has some experience tuning ocamldoc ( > http://argot.x9c.fr/ ), maybe he could comment on the feasibility of > this. You could ask on the caml-list, maybe cc-ing him. If you wished > to have a try at it directly, looking at how Argot is implemented > would be a good source of inspiration. > > (There used to be a custom documentation generator for Batteries, but > afaik. we mostly ditched it because, while it was nice, it made > documentation generation time impossibly slow...) > > On Wed, Feb 15, 2012 at 6:01 AM, Francois Berenger > wrote: > > Hello, > > > > It would be really cool when while looking at the HTML doc > > it would be possible to click somewhere so that the implementation > > code unrolls under the doc text. > > > > Because sometimes the text is not explicit enough, > > some other times there is no text. > > > > Hoogle has such feature and it was pretty useful when > > I was coding in Haskell (maybe especially useful > > because I was a beginner in that language), for example: > > > > http://www.haskell.org/hoogle/?hoogle=map > > > > Just click on map to have a look at the corresponding implementation. > > > > Regards, > > F. > > > > > > _______________________________________________ > > Batteries-devel mailing list > > Batteries-devel@lists.forge.ocamlcore.org > > https://lists.forge.ocamlcore.org/cgi-bin/listinfo/batteries-devel > > -- > Caml-list mailing list. Subscription management and archives: > https://sympa-roc.inria.fr/wws/info/caml-list > Beginner's list: http://groups.yahoo.com/group/ocaml_beginners > Bug reports: http://caml.inria.fr/bin/caml-bugs >