Comment connaître les versions des fichiers utilisées dans un document ?#

  • La commande \listfiles affiche, lors de la compilation, les versions, dates, auteurs et commentaires disponibles sur les fichiers inclus. Cette commande n’est autorisée que dans le préambule.

1.  À quoi ça sert ?#

Lorsque vous échangez un document avec quelqu’un d’autre (dans le cadre d’un développement en commun, par exemple), il est préférable que les deux correspondants disposent du même jeu de fichiers, en plus du document en question. Pour être plus précis, votre correspondant a évidemment besoin d’avoir les mêmes extensions (si vous utilisez l’extension url, il doit aussi l’avoir, par exemple), mais il y a des cas où il devra avoir en plus les mêmes versions. Si par exemple vous disposez d’une version exempte de bogues du package tout_nouveau_tout_neuf mais que votre collaborateur a toujours une version antérieure, instable… vous allez vous arracher les cheveux jusqu’à ce que vous compreniez que le problème ne vient pas de votre code, mais de cette extension !

La solution la plus simple est d’utiliser la commande \listfiles. Elle écrit une liste des fichiers utilisés et de leur numéro de version dans le fichier journal. Vous pouvez ainsi récupérer cette liste et la transmettre avec votre fichier, et votre collaborateur n’aura qu’à la comparer à la sienne en cas de problème.

Exemple de sortie :

\listfiles

\documentclass{article}
  \usepackage[T1]{fontenc}
  \usepackage{lmodern}
  \usepackage[french]{babel}
\begin{document}
Penser à se coucher de bonne heure.
\end{document}
*File List*
article.cls    2020/04/10 v1.4m Standard LaTeX document class
 size10.clo    2020/04/10 v1.4m Standard LaTeX file (size option)
fontenc.sty
lmodern.sty    2009/10/30 v1.6 Latin Modern Fonts
  babel.sty    2021/03/03 3.55 The Babel package
 french.ldf    2020/10/10 v3.5l French support from the babel system
scalefnt.sty
 keyval.sty    2014/10/28 v1.15 key=value parser (DPC)
  t1lmr.fd    2009/10/30 v1.6 Font defs for Latin Modern
l3backend-pdftex.def    2021-03-18 L3 backend support : PDF output (pdfTeX)
***********

Attention, \listfiles n’enregistre que les fichiers qui sont inclus par les mécanismes « standards » (comme \documentclass, \usepackage, \include, \includegraphics et ainsi de suite). La commande \input, fournie par et utilisée avec la syntaxe comme ceci :

  \input{mymacros}

enregistre bien les détails du fichier mymacros.tex, mais si vous l’utilisez avec la syntaxe d’une primitive comme ceci :

  \input mymacros

mymacros.tex ne sera pas enregistré, et ne sera donc pas répertorié par \listfiles, puisque vous avez contourné son mécanisme qui enregistre les appels à des fichiers.

2.  Comment faire une archive des fichiers utilisés ?#

L’extension snapshot vous fournit une liste des dépendances d’un document sous une forme que vous pourrez intégrer en tête de document. L’objectif de cette extension est de créer des copies d’archives de documents, mais elle est également utile pour simplement d’échanger des documents.

Par exemple avec le document précédent, cette extension crée un fichier mon_document.dep qui contient :

\RequireVersions{
  *{application}{pdfTeX}  {0000/00/00 v1.40.21}
  *{format} {LaTeX2e}     {2020-10-01 v2.e}
  *{class}  {article}     {2020/04/10 v1.4m}
  *{file}   {size10.clo}  {2020/04/10 v1.4m}
  *{package}{fontenc}     {0000/00/00 v0.0}
  *{package}{lmodern}     {2009/10/30 v1.6}
  *{package}{babel}       {2021/03/03 v3.55}
  *{file}   {french.ldf}  {2020/10/10 v3.5l}
  *{package}{scalefnt}    {0000/00/00 v0.0}
  *{package}{keyval}      {2014/10/28 v1.15}
  *{package}{snapshot}    {2020/06/17 v2.14}
  *{file}   {t1lmr.fd}    {2009/10/30 v1.6}
  *{file}   {l3backend-pdftex.def}{2021-03-18 v3}
}

Vous pourrez ensuite appeler le package bundledoc, qui utilisera cet « instantané » pour construire une archive (une fichier .tar.gz ou .zip) contenant les fichiers nécessaires à votre document ; il est fourni avec des fichiers de configuration pour une utilisation avec Live sous Unix ou sous Windows. Il est surtout utile lorsque vous envoyez la première copie d’un document à un collaborateur.

3.  Comment surveiller la compilation ?#

Le programme mkjobtexmf lance tex (ou autre) et surveille quels fichiers sont utilisés pendant la compilation, soit grâce à l’option -recorder de tex, soit en appelant la commande Unix strace pour garder un œil sur ce que fait tex. Les fichiers ainsi trouvés sont copiés (ou liés) dans un répertoire de type texmf, qui pourra être sauvegardé pour être transmis ou archivé.