From mboxrd@z Thu Jan  1 00:00:00 1970
Received: (from majordomo@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id NAA02919; Tue, 17 Jun 2003 13:28:54 +0200 (MET DST)
X-Authentication-Warning: pauillac.inria.fr: majordomo set sender to owner-caml-list@pauillac.inria.fr using -f
Received: from nez-perce.inria.fr (nez-perce.inria.fr [192.93.2.78]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id NAA02674 for <caml-list@pauillac.inria.fr>; Tue, 17 Jun 2003 13:28:53 +0200 (MET DST)
Received: from mail1.tpgi.com.au (mail.tpgi.com.au [203.12.160.57])
	by nez-perce.inria.fr (8.11.1/8.11.1) with ESMTP id h5HBSoT26277
	for <caml-list@inria.fr>; Tue, 17 Jun 2003 13:28:51 +0200 (MET DST)
Received: from ozemail.com.au (syd-ts18-2600-024.tpgi.com.au [203.58.21.24])
	(authenticated (0 bits))
	by mail1.tpgi.com.au (8.11.6/8.11.6) with ESMTP id h5HBSkk00676
	for <caml-list@inria.fr>; Tue, 17 Jun 2003 21:28:48 +1000
Message-ID: <3EEEFB6E.1050002@ozemail.com.au>
Date: Tue, 17 Jun 2003 21:28:46 +1000
From: John Skaller <skaller@ozemail.com.au>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.2.1) Gecko/20010901
X-Accept-Language: en-us
MIME-Version: 1.0
To: caml-list@inria.fr
Subject: [Caml-list] ocaml doc
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Spam: no; 0.00; ozemail:01 ocamldoc:01 annotations:01 srcref:01 overflows:01 indented:01 val:01 toxteth:01 glebe:01 2037,:01 9660:01 0850:01 ocaml:01 int:01 nsw:01 
Sender: owner-caml-list@pauillac.inria.fr
Precedence: bulk

Ocamldoc didn't understand the following annotations:

type srcref =
   string (** filename *) *
   int (** line number, 1 origin *) *
   int (** starting column, 1 origin *) *
   int (** ending column, 1 origin *)

Anyone else think this might be useful?

It also won't label polymorphic variant components ..
type X = [
	| `A (** an A *)
	| `B (** a B *)
]

but from the guide examples the following is
supposed to work and does:

type weather =
| Rain of int (** The comment for construtor Rain *)
| Sun (** The comment for constructor Sun *)

-------------------------------------
Minor qibble: the html formatting of
function signatures isn't very sweet.
When one overflows, the new line starts
hard on the left margin (it should be indented).
Also, if there is going to be an overflow,
all the components at the top level should be
on a separate line like:

	val f:
		A -> 

		B ->
		C ->
		D

or perhaps

	val f:
		A
		-> B (* comment .. *)
		-> C (* comment .. *)

Another minor quibble: I tried to latex
the -latex output, and it couldn't find
the style file ocamldoc.sty. I had to copy
it manually to where I needed it. But the -html
generator copies the style.css file where its needed.

-- 
John Max Skaller, mailto:skaller@ozemail.com.au
snail:10/1 Toxteth Rd, Glebe, NSW 2037, Australia.
voice:61-2-9660-0850


-------------------
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