Mantis Bug Tracker

View Issue Details Jump to Notes ] Issue History ] Print ]
IDProjectCategoryView StatusDate SubmittedLast Update
0001305OCamlOCaml generalpublic2002-08-07 19:212002-08-09 14:32
Reporteradministrator 
Assigned To 
PrioritynormalSeverityminorReproducibilityalways
StatusclosedResolutionfixed 
PlatformOSOS Version
Product Version 
Target VersionFixed in Version 
Summary0001305: ocamldoc & latex
DescriptionÇa fait quelques semaines que je ne peux pas générer la documentation
de Cash en mode latex: le généré n'est pas digéré par Latex:

   ! LaTeX Error: Something's wrong--perhaps a missing \item.

   See the LaTeX manual or LaTeX Companion for explanation.
   Type H <return> for immediate help.
    ...

   l.7389 \end{ocamldocdescription}

   ?

Je l'ai signalé par oral vers la mi-juillet à Maxence, qui m'a dit que
Didier allait intervenir fin juillet pour faire du latex plus robuste.
Comme la 3.06 va sortir, et que je suis prêt à faire une release de
Cash également, je suis assez embêté car je me vois mal distribuer en
disant: Bah, il n'y a plus qu'une documentation html, y'a un problème
avec ocamldoc et latex, soyez patients... Je ne trouverais pas ça
très sérieux.

Évidemment, ce serait mieux si c'était fait pour la 3.06, ça
m'éviterait d'avoir à dire: Ah, la documentation, il faut un ocamldoc
version CVS... Mais au moins si je peux en fournir une en dvi/ps, ce
sera supportable.

Je pars en congés vendredi après-midi jusqu'au 26 août. Je désespère
de faire une release avant mon départ... Si déjà je pouvais la faire
fin août...

Merci d'avance,
Bruno.

PS: pour reproduire: prendre Cash dans CVS et faire make latex.

TagsNo tags attached.
Attached Files

- Relationships

-  Notes
(0001017)
administrator (administrator)
2002-08-08 09:41


> Ça fait quelques semaines que je ne peux pas générer la documentation
> de Cash en mode latex: le généré n'est pas digéré par Latex:
>
> ! LaTeX Error: Something's wrong--perhaps a missing \item.
>
> See the LaTeX manual or LaTeX Companion for explanation.
> Type H <return> for immediate help.
> ...
>
> l.7389 \end{ocamldocdescription}
>
> ?
>
> Je l'ai signalé par oral vers la mi-juillet à Maxence, qui m'a dit que
> Didier allait intervenir fin juillet pour faire du latex plus robuste.
> Comme la 3.06 va sortir, et que je suis prêt à faire une release de
> Cash également, je suis assez embêté car je me vois mal distribuer en
> disant: Bah, il n'y a plus qu'une documentation html, y'a un problème
> avec ocamldoc et latex, soyez patients... Je ne trouverais pas ça
> très sérieux.

Je t'avais envoyé une incantation de didier à rajouter pour que cela
passe. L'as-tu essayée ? Elle marchait pour ton cas.
Par ailleurs, pourrais-tu me la renvoyer, stp ? (j'ai écrasé le mel).
Je pourrais l'incorporer à ce que génère ocamldoc.

--
Maxence

(0001018)
administrator (administrator)
2002-08-08 12:07

   Date: Thu, 8 Aug 2002 09:41:00 +0200
   From: Maxence Guesdon <maxence.guesdon@inria.fr>

   > Ça fait quelques semaines que je ne peux pas générer la documentation
   > de Cash en mode latex: le généré n'est pas digéré par Latex:
   > ! LaTeX Error: Something's wrong--perhaps a missing \item.
   >
   > See the LaTeX manual or LaTeX Companion for explanation.
   > Type H <return> for immediate help.
   > ...
   >
   > l.7389 \end{ocamldocdescription}
   >
   > ?
   Je t'avais envoyé une incantation de didier à rajouter pour que cela
   passe. L'as-tu essayée ? Elle marchait pour ton cas.
Oui, en effet. Mais je me vois mal patcher le .tex dans ma Makefile
(il y a mieux comme ingénierie).
   Par ailleurs, pourrais-tu me la renvoyer, stp ? (j'ai écrasé le mel).
   Je pourrais l'incorporer à ce que génère ocamldoc.
Je te la joins.

Par ailleurs, peux-tu en profiter pour remplacer, avec -html, le texte
des URL pointant sur une section, qui est actuellement le nom du
label, par le nom de la section ? On en avait parlé dans le couloir à
l'époque, et tu avais l'air d'accord.

Merci,
Bruno.


----------------
Date: Fri, 12 Jul 2002 11:20:53 +0200
From: Maxence Guesdon <maxence.guesdon@inria.fr>
To: Bruno.Verlyck@inria.fr
Subject: Re: problXmes ocamldoc
Content-Type: text/plain; charset=ISO-8859-1

On Thu, 11 Jul 2002 15:15:40 +0200 Bruno.Verlyck@inria.fr wrote:
> Date: Thu, 11 Jul 2002 10:01:25 +0200
> From: Maxence Guesdon <maxence.guesdon@inria.fr>
>
> J'ai essayé ton code et je n'ai pas d'erreur de LaTeX... Aurais-tu un
> fichier exemple ?
> Le mieux est de prendre Cash depuis CVS (je viens de commettre, ce n'est pas
> encore sur camlcvs), et d'essayer make dvi.
J'ai vu le problème et j'ai appelé didier à l'aide. Il trouve que le fichier
ocamldoc.sty définit des environnements pas très robustes. Il va regarder d'ici
la fin du mois. En attendant, tu peux ajouter la commande suivante dans ton
document tex, avant le \begin{document}:
 \makeatletter
 \def\paragraph{\@startsection {paragraph}{4}{\z@ }{3.25ex \@plus 1ex \@minus .2ex}{0.1ex}{\normalfont \normalsize \bfseries }}
 \makeatother

Maxence
----------------
----------------
(0001019)
administrator (administrator)
2002-08-09 14:32

Fixed 2002-08-08 by Maxence and Didier.

- Issue History
Date Modified Username Field Change
2005-11-18 10:13 administrator New Issue


Copyright © 2000 - 2011 MantisBT Group
Powered by Mantis Bugtracker