Sur le CTAN, concernant le package answers, la documentation (format pdf) ne correspond pas au contenu du fichier dtx : plus précisément, quand je génère cette documentation chez moi (à partir des fichiers ins et dtx disponibles ici), j'ai beaucoup plus de sections (les 7 à 11). Ces sections m'intéressaient puisqu'elles définissent des commandes précédemment utilisées dans la documentation.

Est-ce un bug à faire remonter ? Ou bien est-ce normal/volontaire (je ne regarde jamais les fichiers dtx... j'ignore si c'est "habituel" qu'il y ait de telles différences) ?

Posée 27 Déc '19, 21:02

Mathieu2L's gravatar image

Mathieu2L
356518
Taux d'acceptation : 80%

Normalement un fichier .dtx contient ce qu'il va au .pdf ainsi que ce qu'il va au .sty.

(27 Déc '19, 21:20) touhami touhami's gravatar image

Ce n'est pas un bug : le fichier .dtx contient la commande \StopEventually, qui permet de séparer la partie "documentation" de la partie "code".

Les commandes \OnlyDescription et \AlsoImplementation définissent \StopEventually soit pour arrêter la compilation (pour n'avoir que le début de la documentation), soit pour la continuer (et inclure le source commenté).

Par défaut, doc.sty appelle \AlsoImplementation, et vous obtenez la documentation complète. Vous pouvez compiler le document suivant pour avoir la documentation courte :

Ouvrir dans l'éditeur Overleaf
\AtBeginDocument{\OnlyDescription}
\input{answers.dtx}
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Lien permanent

Publiée 27 Déc '19, 22:36

nmarkey's gravatar image

nmarkey
1.4k29
Taux d'acceptation : 45%

Un fichier .dtx est le code source documenté d'une extension ou d'une partie du noyau LateX. Il contient le code source de la documentation (.pdf ou .dvi) et le code source de l'extension elle même (.sty).

Lancer pdflatex answers.dtx et vous obtenez la documentation .pdf.

Lancer (pdf)latex answers.ins et vous obtenez le code de l'extension .sty.

En effet le fichier answers.ins (comme presque tout le .ins) contient une commande :

\generate{\file{answers.sty}{\from{answers.dtx}{answers}}} ou \generateFile.

qui extrait le fichier answers.sty à partir de answers.dtx.

Lien permanent

Publiée 27 Déc '19, 22:10

touhami's gravatar image

touhami
9.9k410
Taux d'acceptation : 51%

Votre réponse
[Masquer l'aperçu]

Suivre cette question

Par courriel :

Une fois que vous serez enregistré, vous pourrez souscrire à n'importe quelle mise à jour ici

Par flux RSS :

Réponses

Réponses et commentaires

Mots-clés de la question :

×9
×3

Question posée : 27 Déc '19, 21:02

Question vue : 3,999 fois

Dernière mise à jour : 27 Déc '19, 22:36

C'est votre première visite ici ? Consultez la FAQ !

×