CTAN `answers` : fichier dtx et pdf differents

3

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
356●4●18
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
2 réponses :
En coursAnciennesRécentesPopulaires
3

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}
Lien permanent

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

nmarkey's gravatar image

nmarkey
1.4k●2●9
Taux d'acceptation : 45%

2

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.7k●4●10
Taux d'acceptation : 51%

Votre réponse
(dés)activer 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

Bases de Markdown

  • *italique* ou _italique_
  • **gras** ou __gras__
  • Lien ::[texte](http://url.com/ "Titre ")
  • Image : ?![alt texte](/path/img.jpg "Titre ")
  • Liste numérotée : 1. Foo 2. Bar
  • Pour ajouter un passage à la ligne, ajoutez deux espaces à l'endroit où vous souhaitez que la ligne commence.
  • Les balises HTML de base sont également prises en charge.

En savoir plus sur Markdown