[latexrefman-commits] [SCM] latexrefman updated: r879 - trunk

[vincentb1 at gnu.org.ua]

Author: vincentb1
Date: 2020-12-24 13:09:50 +0200 (Thu, 24 Dec 2020)
New Revision: 879

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
   trunk/latex2e.texi
Log:
[fr,en] \bibitem.

* latex2e-fr.texi (\bibitem): Align on English.

* latex2e.texi (\bibitem): Minor rewordings. Add forward reference to Jobname node.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2020-12-23 20:22:06 UTC (rev 878)
+++ trunk/ChangeLog	2020-12-24 11:09:50 UTC (rev 879)
@@ -1,3 +1,9 @@
+2020-12-24  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
+	* latex2e-fr.texi (\bibitem): Align on English.
+
+	* latex2e.texi (\bibitem): Minor rewordings. Add forward reference to Jobname node.
+
 2020-12-23  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
 	* latex2e.texi (thebibliography): Add reference to node list for

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2020-12-23 20:22:06 UTC (rev 878)
+++ trunk/latex2e-fr.texi	2020-12-24 11:09:50 UTC (rev 879)
@@ -7352,29 +7352,78 @@
 @findex \bibitem
 
 Synopsis :
+
 @example
+\bibitem@{@var{clef_de_cite}@}
+ at end example
+
+ at noindent
+ou :
+
+ at example
 \bibitem[@var{étiquette}]@{@var{clef_de_cite}@}
 @end example
 
-La commande @code{\bibitem} génère une entrée étiquetée par
- at var{étiquette}. Si l'argument @var{étiquette} est omis, un numéro est
-automatiquement généré en utilisant le compteur @code{enumi}. L'argument
+La commande @code{\bibitem} génère un article étiqueté par défaut par un
+numéro généré en utilisant le compteur @code{enumi}. L'argument
 @var{clef_de_cite} est une
 @cindex clef de référence bibiliographique
 @cindex référence bibiliographique, clef
 @dfn{clef de référence bibiliographique} consistant
-en une séquence quelconque de lettres, chiffres, et signes de
-ponctuation ne contenant aucune virgule.
+en une chaîne quelconque de lettres, chiffres, et signes de
+ponctuation (hormis la virgule).
 
-Cette commande écrit une entrée dans le fichier @file{.aux}, et cette
-entrée contient les @var{étiquette} et @var{clef_de_cite} de l'article
-considéré. Lorsque le fichier @file{.aux} est lu par la commande
- at code{\begin@{document@}}, l'@var{étiquette} de l'article est associée à
-sa @var{clef_de_cite}, ce qui a pour effet que toute référence à
- at var{clef_de_cite} avec une commande @code{\cite} (@pxref{\cite})
-produit l'@var{étiquette} associée.
+ at xref{thebibliography}, pour un exemple.
 
+L'argument optionnel @var{étiquette}, lorsqu'il est présent, sert
+d'étiquette et le compteur @code{enumi} n'est pas incrémenté.  Dans
+l'exemple suivant :
 
+ at example
+\begin@{thebibliography@}
+\bibitem[Lamport 1993]@{latexdps@} 
+  Leslie Lamport. 
+  \textit@{\LaTeX@{@}: a document preparation system@}. 
+  Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem@{texbook@} 
+  Donald Ervin Knuth. 
+  \textit@{The \TeX book@}. 
+  Addison-Wesley, Reading, Massachusetts, 1983.
+\end@{thebibliography@}
+ at end example
+
+ at noindent
+le premier article est formaté comme @samp{[Lamport 1993] Leslie ...}
+(la quantité d'espace horizontal que @LaTeX{} laisse pour l'étiquette
+dépend de l'argument @var{étiquette-la-plus-large} de l'environnement
+ at code{thebibliography} ; voir @ref{thebibliography}).
+De même, @code{... s'appuyant sur \cite@{latexdps@}} produit
+ at samp{... s'appuyant sur [Lamport 1994]}.
+
+Si vous mélangez des articles @code{\bibitem} avec et sans
+ at var{étiquette}, alors @LaTeX{} numérote ceux sans séquentiellement.
+Dans l'exemple ci-dessus l'article @code{texbook} apparaît comme
+ at samp{[1] Donald ...}, bien que ce soit le deuxième article.
+
+Si vous utilisez la même @var{clef_de_cite} deux fois, alors vous
+obtenez @samp{LaTeX Warning: There were multiply-defined labels}.
+
+En coulisse, @LaTeX{} se souvient de l'information @var{clef_de_cite} et
+ at var{étiquette} parce que @code{\bibitem} écrit dans le fichier
+auxiliaire @file{@var{jobname}.aux} (@pxref{Jobname}).  Par exemple dans
+l'exemple ci-dessus ce fichier contient
+ at code{\bibcite@{latexdps@}@{Lamport, 1993@}} et
+ at code{\bibcite@{texbook@}@{1@}}.  Le fichier @file{.aux} est lu par la
+commande @code{\begin@{document@}} et alors l'information devient
+disponible pour les commandes @code{\cite}.  Ceci explique qu'il est
+nécessaire d'exécuter @LaTeX{} deux fois pour que les références soient
+résolues : une pour l'écrire, et une pour le relire.
+
+À cause de cet algorithme en deux passes, quand vous ajourez un
+ at code{\bibitem} ou changez sa @var{clef_de_cite} vous pouvez obtenir
+ at samp{LaTeX Warning: Label(s) may have changed. Rerun to get
+cross-references right}.  La solution est de recompiler.
+
 @node \cite
 @subsection @code{\cite}
 

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2020-12-23 20:22:06 UTC (rev 878)
+++ trunk/latex2e.texi	2020-12-24 11:09:50 UTC (rev 879)
@@ -7681,16 +7681,16 @@
 \bibitem[@var{label}]@{@var{cite_key}@}
 @end example
 
-Generate an entry labeled by @var{label}.  The default is for @LaTeX{} to
-generates a number using the @code{enumi} counter.  The @dfn{citation key} 
+Generate an entry labeled by default by a number generated using the
+ at code{enumi} counter.  The @dfn{citation key}
 @cindex citation key
- at var{cite_key} is a string of
+ at var{cite_key} can be any string of
 letters, numbers, and punctuation symbols (but not comma).
 
 @xref{thebibliography}, for an example.
 
-The optional @var{label} changes the default label from an integer to the
-given string.  With this
+When provided, the optional @var{label} becomes the entry label and the
+ at code{enumi} counter is not incremented.  With this
 
 @example
 \begin@{thebibliography@}
@@ -7722,7 +7722,7 @@
 
 Under the hood, @LaTeX{} remembers the @var{cite_key} and @var{label}
 information because @code{\bibitem} writes it to the auxiliary file
- at file{@var{filename}.aux}.  For instance, the above example causes
+ at file{@var{jobname}.aux} (@pxref{Jobname}).  For instance, the above example causes
 @code{\bibcite@{latexdps@}@{Lamport, 1993@}} and
 @code{\bibcite@{texbook@}@{1@}} to appear in that file.  The @file{.aux}
 file is read by the @code{\begin@{document@}} command and then the