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 PAA29901; Mon, 30 Aug 2004 15:42:40 +0200 (MET DST)
X-Authentication-Warning: pauillac.inria.fr: majordomo set sender to owner-caml-list@pauillac.inria.fr using -f
Received: from concorde.inria.fr (concorde.inria.fr [192.93.2.39]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id PAA30596 for <caml-list@pauillac.inria.fr>; Mon, 30 Aug 2004 15:42:39 +0200 (MET DST)
Received: from tintin.inria.fr (tintin.inria.fr [128.93.24.126])
	by concorde.inria.fr (8.13.0/8.13.0) with SMTP id i7UDgdkE003941;
	Mon, 30 Aug 2004 15:42:39 +0200
Date: Mon, 30 Aug 2004 15:42:39 +0200
From: Maxence Guesdon <maxence.guesdon@inria.fr>
To: skaller@users.sourceforge.net
Cc: caml-list <caml-list@inria.fr>
Subject: Re: [Caml-list] Ocamldoc problem
Message-Id: <20040830154239.62d7c5bb@tintin.inria.fr>
In-Reply-To: <1093749214.15255.2244.camel@pelican.wigram>
References: <1093749214.15255.2244.camel@pelican.wigram>
Organization: INRIA
X-Mailer: Sylpheed version 0.9.10claws (GTK+ 1.2.10; i686-pc-linux-gnu)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-Miltered: at concorde with ID 41332ECF.000 by Joe's j-chkmail (http://j-chkmail.ensmp.fr)!
X-Loop: caml-list@inria.fr
X-Spam: no; 0.00; maxence:01 guesdon:01 maxence:01 guesdon:01 caml-list:01 ocamldoc:01 2004:99 sourceforge:01 ocamldoc:01 mli:01 flx:01 impl:01 mli:01 flx:01 impl:01 
Sender: owner-caml-list@pauillac.inria.fr
Precedence: bulk

On 29 Aug 2004 13:13:38 +1000
skaller <skaller@users.sourceforge.net> wrote:

> Using Ocamldoc to make latex files, I am getting a weird problem:
> 
> ! LaTeX Error: Environment ocamldocobjectend undefined.
>  
> When I look in the generated ocamldoc.sty file:
> 
> \ProvidesPackage{ocamldoc}
>               [2001/12/04 v1.0 ocamldoc support]
>  
> I can see that Latex is wrong -- here's the definition
> I found in the file:
> 
> \newenvironment{ocamldocobjectend}
>      {\noindent\quad\texttt{object}\ocamldocindent}
>      {\endocamldocindent\vskip -\lastskip
>       \noindent\quad\texttt{end}\medskip}
>  
> Here is the command I use:
> 
> ocamldoc -I src -d impldoc src/*.mli -html
> ocamldoc -I src -o impldoc/flx_impl.tex src/*.mli -latex
> cd impldoc
> latex flx_impl.tex
> 
> Ok, now here is the WEIRD part. If I do this first:
> 
> rm impldoc/*
> 
> it all works. (Well I do get
>   LaTeX Warning: There were multiply-defined labels.
> but that's another issue)
> 
> I can even rerun ocamldoc:
> 
> ocamldoc -I src -o impldoc/flx_impl.tex src/*.mli -latex
> latex flx_impl.tex
> 
> 
> and it STILL works. But sometime later, it stops working :)
> 
> Clearly something left over from a previous run is
> getting the way but I can't figure out what. It seems
> to happen even when I 'clean' everything first --
> but then when I try to do that manually the problem goes
> away .. for a while.

The new ocamldocobjectend environment used in ocamldoc latex output was
introduced in version 3.08.0. If you have an earlier version of ocamldoc.sty
in the directory you generate the .tex files, it is not removed by ocamldoc,
and probably does not contain the definition of ocamldocobjectend. But If
there is no such file, ocamldoc generates the default one, with the correct
definitions.

Regards,

Maxence Guesdon

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