Version française
Home     About     Download     Resources     Contact us    
Browse thread
[Caml-list] Ocamldoc problem
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: -- (:)
From: Maxence Guesdon <maxence.guesdon@i...>
Subject: Re: [Caml-list] Ocamldoc problem
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