From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail4-relais-sop.national.inria.fr (mail4-relais-sop.national.inria.fr [192.134.164.105]) by walapai.inria.fr (8.13.6/8.13.6) with ESMTP id pA4AL8bB023614 for ; Fri, 4 Nov 2011 11:21:09 +0100 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AgoDACO8s07U4367kWdsb2JhbABDhHqjcYEgIgEBAQEJCwsHFAMbB4FyAQEFI1YQCxoCJgICVwYTCYd7BqJ+kg2BMIIXhE6BFgSMWYx0jDY X-IronPort-AV: E=Sophos;i="4.69,455,1315173600"; d="scan'208";a="116886582" Received: from moutng.kundenserver.de ([212.227.126.187]) by mail4-smtp-sop.national.inria.fr with ESMTP; 04 Nov 2011 11:21:09 +0100 Received: from office1.lan.sumadev.de (dslb-094-219-215-251.pools.arcor-ip.net [94.219.215.251]) by mrelayeu.kundenserver.de (node=mreu2) with ESMTP (Nemesis) id 0Lv6YQ-1QvDTg1ING-00zpX2; Fri, 04 Nov 2011 11:18:38 +0100 Received: from [192.168.0.29] (dslb-084-058-039-158.pools.arcor-ip.net [84.58.39.158]) by office1.lan.sumadev.de (Postfix) with ESMTPSA id D54D6C00C7; Fri, 4 Nov 2011 11:18:37 +0100 (CET) From: Gerd Stolpmann To: "forum@x9c.fr" Cc: caml users In-Reply-To: <7EB42100-0E5F-4FBB-8CB8-A318926F0E0E@x9c.fr> References: <7EB42100-0E5F-4FBB-8CB8-A318926F0E0E@x9c.fr> Content-Type: text/plain; charset="UTF-8" Date: Fri, 04 Nov 2011 11:18:36 +0100 Message-ID: <1320401916.14475.269.camel@thinkpad> Mime-Version: 1.0 X-Mailer: Evolution 2.28.3 Content-Transfer-Encoding: 7bit X-Provags-ID: V02:K0:l9nMvdl9XewdZpky4Ohan8ZsIh814MDcTBRQSvI0v0u MaX7Xg9HqEFu2jGwcg2CPXqpbAuNVM/a25alqgZfnFvSqJe8Xc 2etWKRXbUOvfGdav30+KhCGtNBCTpWOcLQDu6xp+67eX6pWZKL JBCEr3WQhCaSDgxPDjGsXa82MoeHoPd0JjdaOWffm5LEMl/pXd Vy9OKqE457ZKxv7HGp6elE8DkUE2SOTpo7f9J04dh0whMcTut4 0Mrf0XDUejxTv8AOsr0zDNLAXcfmQNiINLLIWqAezziW5xEAPP 3y+TsAnCu8pJ3X0cybcNqYP239xsVcmG9ZXjHqiLZ5WCI2KTep JrFyNW/DrGSupPPjQyFeNaVsMvbwEafdM6xp+1BJ8 Subject: Re: [Caml-list] [ANN] Argot: 1.0 release Excellent! I'll definitely use it. Another idea for a feature: more options how classes and modules are shown. For example, I once had the problem that I wanted an included module also to be included in-place in the documentation (rather than by reference/link). I modified the ocamldoc generator to get this effect, and the result is here: http://projects.camlcity.org/projects/dl/pxp-1.2.1/doc/manual/html/ref/Pxp_types.html The grey box contains actually the included definitions. This is much easier to understand for the casual reader. The feature is accompanied by a link rewriter, so the ocamldoc-generated links point to the including module rather the included module. A similar problem occurs for inherited class types. Of course, one wants to enable this on a case-by-case basis. I blogged about this some years ago: http://blog.camlcity.org/blog/pxp121.html The generator (very specific to this case): https://godirepo.camlcity.org/svn/lib-pxp/tags/pxp-1.2.1/tools/src/odoc/chtml.ml Gerd Am Mittwoch, den 02.11.2011, 19:29 +0100 schrieb forum@x9c.fr: > Dear list, > > This post announces the 1.0 release of the Argot project, whose goal is to provide > an enhanced HTML generator for ocamldoc, released under the GPL v3. > > Home page: http://argot.x9c.fr > Preview page (for search feature): http://argot.x9c.fr/distrib/argot-3.12-libref/index.html > Forge page: https://forge.ocamlcore.org/projects/argot/ > > Main changes since 1.0-beta: > - new '-search' command-line switch to generate search information > (available on HTML pages through the magnifying glass icon) > - search by exact name > - search by name using regular expression > - search by type using isomorphisms (experimental) > - new '-definitions' command-line switch to load variables from file > - correct handling of embedded tables > - more predefined licenses for the '@license' tag > - some refactoring > > > Xavier Clerc > > > -- ------------------------------------------------------------ Gerd Stolpmann, Darmstadt, Germany gerd@gerd-stolpmann.de Creator of GODI and camlcity.org. Contact details: http://www.camlcity.org/contact.html Company homepage: http://www.gerd-stolpmann.de *** Searching for new projects! Need consulting for system *** programming in Ocaml? Gerd Stolpmann can help you. ------------------------------------------------------------