Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ocamldoc & latex #3513

Closed
vicuna opened this issue Aug 7, 2002 · 3 comments
Closed

ocamldoc & latex #3513

vicuna opened this issue Aug 7, 2002 · 3 comments
Labels

Comments

@vicuna
Copy link

vicuna commented Aug 7, 2002

Original bug ID: 1305
Reporter: administrator
Status: closed
Resolution: fixed
Priority: normal
Severity: minor
Category: ~DO NOT USE (was: OCaml general)

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

@vicuna
Copy link
Author

vicuna commented Aug 8, 2002

Comment author: administrator

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

@vicuna
Copy link
Author

vicuna commented Aug 8, 2002

Comment author: administrator

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


@vicuna
Copy link
Author

vicuna commented Aug 9, 2002

Comment author: administrator

Fixed 2002-08-08 by Maxence and Didier.

@vicuna vicuna closed this as completed Aug 9, 2002
@vicuna vicuna added the bug label Mar 19, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

1 participant