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

vincentb1 at gnu.org.ua vincentb1 at gnu.org.ua
Sun Dec 20 22:43:51 CET 2020


Author: vincentb1
Date: 2020-12-20 23:43:50 +0200 (Sun, 20 Dec 2020)
New Revision: 864

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
   trunk/latex2e.texi
Log:
[fr] array, center, picture.

* latex2e-fr.texi (array, center, picture): Align on English
version.

* latex2e.texi (picture): Minor fixes.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2020-12-19 16:35:19 UTC (rev 863)
+++ trunk/ChangeLog	2020-12-20 21:43:50 UTC (rev 864)
@@ -1,3 +1,8 @@
+2020-12-20  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
+	* latex2e-fr.texi (array, center, picture): Align on English
+	version.
+
 2020-12-18  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
 	* latex2e.texi (\verb): Clarify where visible spaces are produced

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2020-12-19 16:35:19 UTC (rev 863)
+++ trunk/latex2e-fr.texi	2020-12-20 21:43:50 UTC (rev 864)
@@ -33,9 +33,29 @@
 @c xx fusionner latex manuel de la savane
 @c xx fusionner style mathématique hors texte
 @c xx mode veritical, mode horizontal
+ at c xx check recent ltnews for (lots of) changes
+ at c xx \write of non-ASCII chars (vincent mail of 14 Mar 2020 21:39:41)
+ at c xx \nonstopmode etc., if they are officially supported by LaTeX?
+ at c xx JH explain nfss somewhere
+ at c xx JH expand BiBTeX
+ at c xx JH expand theorem, AMS math
+ at c xx JH something on code listings
+ at c xx JH ligatures
+ at c xx JH \xspace
+ at c xx JH \stretch
+ at c xx JH \mathstrut
+ at c xx JH \phantom https://tex.stackexchange.com/questions/4519/how-do-i-create-an-invisible-character
+ at c xx JH \baselineskip https://texfaq.org/FAQ-baselinepar
+ at c xx JH \contentsline, \@@dottedtocline?
+ at c xx JH \numexpr, \dimexpr, \glueexpr, \muexpr
 @c
+ at c xx The typeset source2e has an index with all kernel
+ at c xx commands, though some are internal and shouldn't be included.
+ at c xx classes.dtx et al. define additional commands.
+ at c xx See also http://ctan.org/pkg/macros2e.
+ at c 
+ at c xx All the special characters should be definitively described.
 @c
- at c
 @c xx Notes de P. Bideault
 @c
 @c xx Le sommaire précède immédiatement la table des matières. C'est curieux,
@@ -1653,15 +1673,16 @@
 @PkgIndex{textcomp}
 Enfin, la commande @code{\oldstylenums@{@var{chiffres}@}} sert à
 composer des chiffres dits de ``à l'ancienne'', qui ont des hauteurs et
-profondeur (et parfois largeurs) distincts de l'alignement standard des
-chiffres. Les polices @LaTeX{} par défaut prennent en charge cela, et
-respecteront @code{\textbf} (mais pas les autres styles, il n'y a pas de
-style à l'ancienne italique pour les chiffres en Computer
-Modern). Beaucoup d'autres polices ont des chiffre à l'ancienne aussi;
-parfois le paquetage @code{textcomp} doit être chargé, et parfois des
-options de paquet sont mises à disposition pour en faire le style par
-défaut.  Entrée de FAQ :
- at url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf}.
+profondeurs (et parfois largeurs) distincts de l'alignement standard des
+chiffres qui ont tous la même hauteur que les lettres capitales.
+Les polices @LaTeX{} par défaut prennent en charge cela, et respecteront
+ at code{\textbf} (mais pas les autres styles, il n'y a pas de style à
+l'ancienne italique pour les chiffres en Computer Modern). Beaucoup
+d'autres polices ont des chiffre à l'ancienne aussi ; parfois le
+paquetage @code{textcomp} doit être chargé, et parfois des options de
+paquet sont mises à disposition pour en faire le style par défaut.
+Entrée de FAQ :
+ at url{https://www.texfaq.org/FAQ-osf}.
 
 @LaTeX{} fournit également les commandes suivantes, qui font passer
 inconditionnellement à un style donné, c.-à-d.@: @emph{ne} sont
@@ -3823,6 +3844,7 @@
 \end@{array@}
 @end example
 
+ at noindent
 ou
 
 @example
@@ -3838,11 +3860,29 @@
 une esperluette (@code{&}). Les lignes sont terminées par une double
 contr'oblique (@pxref{\\}).
 
+L'exemple suivant affiche un tableau trois par trois.
+
+ at example
+\begin@{equation*@}
+  \chi(x) =
+  \left|              % barre verticale en bordure
+    \begin@{array@}@{ccc@}
+      x-a  &-b  &-c  \\
+      -d   &x-e &-f  \\
+      -g   &-h  &x-i
+    \end@{array@}
+ \right|
+\end@{equation*@}
+ at end example
+
 L'argument obligatoire @var{patron} décrit le nombre de colonnes,
 l'alignement en leur sein, et le formatage des régions
-inter-colonne. Voir @ref{tabular} pour une description complete de
+inter-colonne. Par exemple,
+ at code{\begin@{array@}@{rcl@}...\end@{array@}} produit trois colonnes :
+la première fer à droite, la deuxième centrée, et la troisière fer à
+gauche. Voir @ref{tabular} pour une description complète de
 @var{patron}, et des autres caractéristiques communes aux deux
-environnement, y compris l'argument optionnel @code{pos}.
+environnements, y compris l'argument optionnel @code{pos}.
 
 L'environnement @code{array} diverge de @code{tabular} par deux
 aspect. Le premier est que les entrée de @code{array} sont composées en
@@ -3947,12 +3987,50 @@
 \end@{center@}
 @end example
 
- at findex \\ (pour @code{center})
 L'environnement @code{center} vous permet de créer un paragraphe
-consistant de lignes qui sont centrée entre les marges de gauche et de
-droite de la page courante. Chaque ligne est terminée avec la chaîne
- at code{\\}.
+consistant de lignes qui sont centrées entre les marges de gauche et de
+droite de la page courante. On utilise une double contr'oblique,
+ at code{\\}, pour obtenir un saut de ligne (@pxref{\\}).
+ at findex \\ @r{(pour @code{center})}
+Si du texte est trop long pour entrer dans une ligne, alors @LaTeX{}
+insère des sauts de ligne en évitant de faire des césures ou de dilater
+ou contracter tout espace inter-mot.
 
+Cet environnement insert de l'espace au-dessus et en-dessou le corps du
+texte. Voir @ref{\centering} pour ne pas avoir cet espace, par exemple
+au sein d'un environnement @code{figure}.
+
+L'exemple suivant produit trois ligne centrées.  Il y a un espace
+vertical supplementaire entre les deux dernière lignes.
+
+ at example
+\begin@{center@}
+  Une thèse soumise en remplissant partiellement \\
+  les exigences de \\[0.5ex]
+  l'École pour l'Ingénierie Environnementale
+\end@{center@}
+ at end example
+
+Dans l'exemple suivant, selon la largeur de la ligne de la page,
+ at LaTeX{} pourrait faire un saut de ligne pour la partie avant la double
+contr'oblique.  SIf so, it will center each of the two lines and if not
+it will center the single line.  Then @LaTeX{} will break at the double
+backslash, and will center the ending.
+
+ at example
+\begin@{center@}
+  Mon père considérait comme intolérable quiconque fréquentait l'église mais ne buvait pas.\\ 
+  J'ai grandi dans cette croyance.  --- Richard Burton 
+\end@{center@}
+ at end example
+
+Ajouter une double contr'oblique à la fin de la ligne finale est
+optionnel.  Lorsque elle est présente, cela n'ajoute pas d'espace
+vertical.
+
+Dans un document en double-colonne le texte est centré dans une colonne,
+et non sur la page entière.
+
 @menu
 * \centering:: Forme déclarative de l'environnement @code{center}.
 @end menu
@@ -3961,6 +4039,7 @@
 @node \centering
 @subsection @code{\centering}
 
+ at c xx Revoir la trad.
 @findex \centering
 @cindex centrer du texte, déclaration pour
 
@@ -5426,7 +5505,7 @@
 
 @example
 \begin@{picture@}(@var{largeur}, at var{hauteur})
- at dots{} @var{commandes picture} @dots{}
+   @var{commande picture}
 \end@{picture@}
 @end example
 
@@ -5435,100 +5514,154 @@
 
 @example
 \begin@{picture@}(@var{largeur}, at var{hauteur})(@var{décalagex}, at var{décalagey})
- at dots{} @var{commandes picture} @dots{}
+  @var{commande picture}
 \end@{picture@}
 @end example
 
+ at noindent
+où on a autant de @var{commande picture}(s) qu'on le désire.
 
- at findex \unitlength
 L'environnement @code{picture} vous permet de créer des dessins simples
 contenant des lignes, des flèches, des boîtes, des cercles, et du texte.
 Cet environnement n'est pas obsolète, mais les nouveaux documents
-utilisent typiquelent des systèmes de création de graphiques bien plus
-puissants tels que TikZ, PStricks, MetaPost, ou Asymptote. Ceux-ci ne
-sont pas couverts dans ce documents ; voir le CTAN.
+utilisent typiquement des systèmes de création de graphiques bien plus
+puissants tels que TikZ, PStricks, MetaPost, ou Asymptote. Aucun de
+ceux-ci n'est couvert dans ce document ; voir le CTAN.
 
- at c xxx Revoir la trad.
-Vous dîtes à @LaTeX{} où mettre les chose dans le dessin en spécifiant
-leur coordonnées. Une coordonnée est un nombre qui peut avoir une
-séparateur décimal (point et non virgule) et un signe moins --- un
-nombre comme @code{5}, @code{0.3} ou @code{-3.1416}.  Une coordonnées
-spécifie une longueur en multiples de l'unité de longueur
- at code{\unitlength}, ainsi si @code{\unitlength} a été réglée à
- at code{1cm}, alors la coordonnée 2.54 spécifie une longueur de 2,54
-centimètres.
+Pour commencer, voici un exemple illustant la méthode du parallélogramme
+pour additionner deux vecteurs.
 
-Vous devriez changer la valeur de @code{\unitlength}, en utilisant la
-commande @code{\setlength}, en dehors d'un environnement
- at code{picture}. La valeur par défaut est @code{1pt}.
+ at findex \unitlength
+ at example
+\setlength@{\unitlength@}@{1cm@}
+\begin@{picture@}(6,6)      % la boîte de l'image fera 6cm de large sur 6cm de haut
+  \put(0,0)@{\vector(2,1)@{4@}@}  % la pente du vecteur est de 1/2
+    \put(2,1)@{\makebox(0,0)[l]@{\ premier terme@}@}
+  \put(4,2)@{\vector(1,2)@{2@}@}
+    \put(5,4)@{\makebox(0,0)[l]@{\ second terme@}@}  
+  \put(0,0)@{\vector(1,1)@{6@}@}
+    \put(3,3)@{\makebox(0,0)[r]@{somme\ @}@}  
+\end@{picture@}
+ at end example
 
- at PkgIndex{picture}
-Le paquetage @code{picture} redéfinit l'environnement @code{picture} de
-sorte qu'où que soit utilisé un nombre au sein de @var{commandes picture}
-pour spécifier une coordonnée, on puisse alternativement utiliser une
-longueur. Notez bien cependant que ceci empèche de dilater/contracter
-ces longueurs en changeant @code{\unitlength}.
+L'environnement @code{picture} a un argument obligatoire qui est une
+pair de nombres réels positifs (@var{largeur}, at var{hauteur}). Le point
+est utilisée comme séparateur décimal quand il ne sont pas entiers. En
+les multipliant par @code{\unitlength} on obtient la taille nominale de
+la sortie, c-à-d.@: l'espace que @LaTeX{} reserve sur la page en
+sortie. Cette taille nominale n'est pas nécessairement la taille réelle
+de l'image ; @LaTeX{} dessine aussi les parties de l'image en dehors de
+la boîte de l'image.
 
- at cindex position, dans un dessin @code{picture}
-Une @dfn{position} est une paire de coordonnées, telle que
- at code{(2.4,-5)}, ce qui spécifie un point d'abscisse @code{2.4} et
-d'ordonnée @code{-5}.  Les coordonnées sont spécifiées de la manière
-habituelle relativement à une origine, qui est normalement dans le coin
-inférieur gauche du dessin. Notez que lorsque une position apparaît en
-argument, elle n'est pas entourée d'accolades ; on délimite l'argument
-avec des parenthèses.
+L'environnement @code{picture} a aussi un argument optionnel
+(@var{décalagex}, at var{décalagey}). Il sert à décaler l'origine.
+Contrairement aux arguments optionnels ordinaire, cet argument n'est pas
+contenu entre crochets. Comme pour l'argument obligatoire, c'est une
+paire de deux nombres. En les multipliant par @code{\unitlength} on
+obtient les coordonnées du point dans le coin inférieur gauche de l'image.
 
-L'environnement @code{picture} a un argument obligatoire qui est une
-position (@var{largeur}, at var{hauteur}) qui spécifie la taille du dessin.
-L'environnement produit une boîte rectangulaire dont les dimensions sont
-cette @var{largeur} et cette @var{hauteur}.
+Par exemple, si @code{\unitlength} a été réglée à @code{1mm}, la
+commande
 
-L'environnement @code{picture} a aussi un argument optionnel de position
-(@var{décalagex}, at var{décalagey}), qui suit l'argument de taille, et qui
-peut changer l'origine.  (Contrairement aux arguments optionnels
-ordinaire, cet argument n'est pas contenu entre crochets.) L'argument
-optionnel donne les coordonnées du point dans le coin inférieur gauche
-du dessin (par là même déterminant l'origine).  Par exemple, si
- at code{\unitlength} a été réglée à @code{1mm}, la commande
-
 @example
 \begin@{picture@}(100,200)(10,20)
 @end example
 
 @noindent produit un dessin de largeur 100 millimetres et hauteur 200
-millimetres, done le coin inférieur gauche est le (10,20) et dont le
-coin supérieur doint est donc le point (110,220).  Lorsque vous dessin
-la première fois un dessin, typiquement vous omettez l'argument
+millimetres. Son origine est le point (10mm,20mm) et donc le coin
+inférieur gauche est là, et le coin supérieur droit est à (110mm,220mm).
+Lorsque vous tracez un dessin, typiquement vous omettez l'argument
 optionnel, laissant l'origine au coin inférieur gauche. Si ensuite vous
 voulez modifier le dessin en translatant tout, vous pouvez juste ajouter
 l'argument optionnel approprié.
 
-L'argument obligatoire de l'environnement détermine la taille nominale
-du dessin. Il n'est pas nécessaire que cela soit en relation à la taille
-réèlle du dessin ; @LaTeX{} vous laissera sans broncher mettre des chose
-en dehors de la boîte définie par la taille du dessin, et même en dehors
-de la page. La taille nominale du dessin est utilisée par @LaTeX{} pour
-la détermination de la quantité de place à prévoir pour lui.
+ at cindex position dans picture
+Chaque @var{commande picture} dit à @LaTeX{} où placer quelque chose en
+donnant sa position. Une @dfn{position} est une paire telle que
+ at code{(2.4,-5)} donnant les coordonnées en x et en y. Une
+ at dfn{coordonnée} n'est pas une longueur, c'est un nombre réel (il
+utilise le point @samp{.} comme séparateur décimal et peut avoir un
+signe moins). Elle spécifie une longueur en terme de la longueur unité
+ at code{\unitlength}, de sorte que si @code{\unitlength} a été réglée à
+ at code{1cm}, alors la coordonnées @samp{2.54} spécifie une longueur de
+2,54 centimètres.
 
-Tout ce qui apparaît dans un dessin @code{picture} est dessiné par la
-commande @code{\put}.  La commande
+La valeur par défaut de @LaTeX{} pour @code{\unitlength} est
+ at code{1pt}. C'est une longueur rigide (@pxref{Lengths}). Utilisez la
+commande @code{\setlength} pour la modifier
+(@pxref{\setlength}). Effectuez ce changement uniquement en dehors de
+l'environnement @code{picture}.
 
+L'environnement @code{picture} prend en charge les expressions
+arithmétiques standardes en plus des nombres.
+
+Les coordonnées sont données relarivement à une origine, qui est par
+défaut au coin en bas à gauche de l'image. Notez que lorsque une
+position apparaît en tant qu'argument, comme dans
+ at code{\put(1,2)@{...@}}, elle n'est pas entourées d'accolades puisque
+les parenthèses servent à délimiter l'argument. De même, contrairement à
+certain système de dessin par ordinateur, l'axe des ordonnées y est
+orienté vers le haut de la page, c-à-d.@: que @math{y = 1} est
+ at emph{au-dessus} de @math{y = 0}.
+
+Il y a quatre manières de placer des chose dans une image : @code{\put},
+ at code{\multiput}, @code{\qbezier}, et @code{\graphpaper}.  La plus
+utilisée est @code{\put}. Le code suivant
+
+
 @example
 \put (11.3,-.3)@{...@}
 @end example
 
- at noindent met l'objet spécifié par @code{...} dans le dessin @code{picture}, avec sont
+ at noindent met l'objet spécifié par @code{...} dans le dessin @code{picture}, avec son
 point de référence aux coordonnées @math{(11.3,-.3)}.  Les points de
 référence des divers objets sont décrits plus bas.
 
 @findex lR box
 La commande @code{\put} crée une @dfn{LR box}.  Vous pouvez mettre tout
-ce qui peut aller dans une  @code{\mbox} (@pxref{\mbox}) dans l'argument
+ce qui peut aller dans une  @code{\mbox} (@pxref{\mbox & \makebox}) dans l'argument
 texte de la commande @code{\put}.  Quand vous faites cela, le point de
-référence devient le coin inférieur gauche de la boîte .
+référence devient le coin inférieur gauche de la boîte. Dans cette image :
 
-Les commandes @code{picture} sont décrites dans les rubriques suivantes.
+ at example
+\setlength@{\unitlength@}@{1cm@}
+...\begin@{picture@}(1,1)
+  \put(0,0)@{\line(1,0)@{1@}@}
+  \put(0,0)@{\line(1,1)@{1@}@}
+\end@{picture@}
+ at end example
 
+ at noindent
+les trois sont juste légèrement à la gauche du point où forment un angle
+les deux lignes.  (À noter aussi que @code{\line(1,1)@{1@}} ne demande
+pas une ligne de longueur un, mais une ligne dont l'étendu selon la
+coordonnée x est de 1).
+
+Les cmmandes @code{\multiput}, @code{qbezier}, et @code{graphpaper} sont
+décrite plus bas.
+
+Vous pouvez également utiliser cet envionnement pour placer une matière
+quelconque à un emplacement exact. Par exemple :
+
+ at example
+\usepackage@{color,graphicx@}  % dans le préambule
+  ...
+\begin@{center@}
+\setlength@{\unitlength@}@{\textwidth@} 
+\begin@{picture@}(1,1)      % reserve un espace large et haut de \textwidth
+  \put(0,0)@{\includegraphics[width=\textwidth]@{desertedisland.jpg@}@}
+  \put(0.25,0.35)@{\textcolor@{red@}@{X Trésor ici@}@}
+\end@{picture@}
+\end@{center@}
+ at end example
+
+ at noindent
+Le X rouge sera précisément à un quart de @code{\textwidth} à droite de
+la marge de gauche, et @code{0.35\textwidth} au dessus du bas de
+l'image.  Un autre exemple de cet utilisation est de placer un code
+similaire dans l'en-tête de page pour obtenir une matière répétée sur
+chaque page.
+
 @menu
 * \circle:: Dessine un cercle.
 * \makebox (picture):: Dessine une boîte de la taille spécifiée.
@@ -5546,7 +5679,40 @@
 * \vector:: Dessine une ligne flèchée.
 @end menu
 
+ at ignore
+ at findex \unitlength
+Vous dîtes à @LaTeX{} où mettre les chose dans le dessin en spécifiant
+leur coordonnées. Une coordonnée est un nombre qui peut avoir une
+séparateur décimal (point et non virgule) et un signe moins --- un
+nombre comme @code{5}, @code{0.3} ou @code{-3.1416}.  Une coordonnées
+spécifie une longueur en multiples de l'unité de longueur
+ at code{\unitlength}, ainsi si @code{\unitlength} a été réglée à
+ at code{1cm}, alors la coordonnée 2.54 spécifie une longueur de 2,54
+centimètres.
 
+Vous devriez changer la valeur de @code{\unitlength}, en utilisant la
+commande @code{\setlength}, en dehors d'un environnement
+ at code{picture}. La valeur par défaut est @code{1pt}.
+
+ at PkgIndex{picture}
+Le paquetage @code{picture} redéfinit l'environnement @code{picture} de
+sorte qu'où que soit utilisé un nombre au sein de @var{commandes picture}
+pour spécifier une coordonnée, on puisse alternativement utiliser une
+longueur. Notez bien cependant que ceci empèche de dilater/contracter
+ces longueurs en changeant @code{\unitlength}.
+
+ at cindex position, dans un dessin @code{picture}
+Une @dfn{position} est une paire de coordonnées, telle que
+ at code{(2.4,-5)}, ce qui spécifie un point d'abscisse @code{2.4} et
+d'ordonnée @code{-5}.  Les coordonnées sont spécifiées de la manière
+habituelle relativement à une origine, qui est normalement dans le coin
+inférieur gauche du dessin. Notez que lorsque une position apparaît en
+argument, elle n'est pas entourée d'accolades ; on délimite l'argument
+avec des parenthèses.
+
+ at end ignore
+
+
 @node \circle
 @subsection @code{\circle}
 @findex \circle
@@ -11254,7 +11420,7 @@
 de boîtes.
 
 @menu
-* \mbox::               Boîtes horizontales.
+* \mbox & \makebox::               Boîtes horizontales.
 * \fbox and \framebox:: Mettre un cadre autour d'une boîte.
 * lrbox::               Un environnement similaire à @code{\sbox}.
 * \makebox::            Boîte, adjustable position.
@@ -11266,7 +11432,7 @@
 @end menu
 
 
- at node \mbox
+ at node \mbox & \makebox
 @section @code{\mbox@{@var{texte@}}}
 @findex \mbox
 
@@ -11476,7 +11642,7 @@
 @end example
 
 @code{\sbox} tape @var{texte} au sein d'une boîte tout comme @code{\mbox}
-(@pxref{\mbox}) à ceci près qu'au lieu que la boîte résultante soit
+(@pxref{\mbox & \makebox}) à ceci près qu'au lieu que la boîte résultante soit
 incluse dans la sortie normale, elle est sauvegardée dans la boîte
 étiquetée @var{\boxcmd}.  @var{\boxcmd} doit avoir été préalablement
 déclarée avec @code{\newsavebox} (@pxref{\newsavebox}).
@@ -12169,9 +12335,12 @@
 @file{pdftex.def} a cette liste d'extensions.
 
 @example
-.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+.pdf,.png,.jpg,.mps,.jpeg,.jbig2,.jb2,.PDF,.PNG,.JPG,.JPEG,.JBIG2,.JB2
 @end example
 
+ at PkgIndex{grfext}
+Pour modifier cet ordre, utilisez le paquetage @code{grfext}.
+
 Vous pouvez utiliser cette commande n'importe où dans le document.  Vous
 pouvez l'utiliser plus d'une fois.  On peut afficher la valeur courante
 avec @code{\makeatletter\typeout@{\Gin@@extensions@}\makeatother}.

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2020-12-19 16:35:19 UTC (rev 863)
+++ trunk/latex2e.texi	2020-12-20 21:43:50 UTC (rev 864)
@@ -6150,7 +6150,7 @@
 Synopses: 
 @example
 \begin@{picture@}(@var{width}, at var{height})
-   @var{picture commands} 
+   @var{picture command}
 \end@{picture@}
 @end example
 
@@ -6159,10 +6159,13 @@
 
 @example
 \begin@{picture@}(@var{width}, at var{height})(@var{xoffset}, at var{yoffset})
-  @var{picture commands}
+  @var{picture command}
 \end@{picture@}
 @end example
 
+ at noindent
+Where there may be any number of @var{picture command}'s.
+
 An environment to create simple pictures containing lines, arrows,
 boxes, circles, and text.  This environment is not obsolete, but new
 documents typically use much more powerful graphics creation systems,
@@ -6179,24 +6182,25 @@
     \put(2,1)@{\makebox(0,0)[l]@{\ first leg@}@}
   \put(4,2)@{\vector(1,2)@{2@}@}
     \put(5,4)@{\makebox(0,0)[l]@{\ second leg@}@}  
-  \put(0,0)@{\line(1,1)@{6@}@}
+  \put(0,0)@{\vector(1,1)@{6@}@}
     \put(3,3)@{\makebox(0,0)[r]@{sum\ @}@}  
 \end@{picture@}
 @end example
 
 The @code{picture} environment has one required argument, a pair of
-numbers (@var{width}, at var{height}).  Multiply these by the value
- at code{\unitlength} to get the nominal size of the output, the space that
- at LaTeX{} reserves on the output page.  This nominal size need not be how
-large the picture really is; @LaTeX{} will draw things from the picture
-outside the picture's box.
+positive real numbers (@var{width}, at var{height}).  Multiply these by the
+value @code{\unitlength} to get the nominal size of the output, i.e.@:
+the space that @LaTeX{} reserves on the output page.  This nominal size
+need not be how large the picture really is; @LaTeX{} will draw things
+from the picture outside the picture's box.
 
 This environment also has an optional argument
 (@var{xoffset}, at var{yoffset}).  It is used to shift the origin.  Unlike
 most optional arguments, this one is not contained in square brackets.
-As with the required argument, it consists of two real numbers.
-Multiply these by @code{\unitlength} to get the point at the lower-left
-corner of the picture.
+As with the required argument, it consists of a pair of two real
+numbers, but these may also be negative or null.  Multiply these
+by @code{\unitlength} to get the coordinates of the point at the
+lower-left corner of the picture.
 
 For example, if @code{\unitlength} has been set to @code{1mm}, the
 command
@@ -6216,14 +6220,14 @@
 
 @cindex position, in picture
 Each @var{picture command} tells @LaTeX{} where to put something by
-naming its position.  A @dfn{position} is a pair such as @code{(2.4,-5)}
+providing its position.  A @dfn{position} is a pair such as @code{(2.4,-5)}
 giving the x- and y-coordinates.  A @dfn{coordinate} is a not a length,
 it is a real number (it may have a decimal point or a minus sign).  It
 specifies a length in multiples of the unit length @code{\unitlength},
 so if @code{\unitlength} has been set to @code{1cm}, then the coordinate
-2.54 specifies a length of 2.54 centimeters.
+ at code{2.54} specifies a length of 2.54 centimeters.
 
- at LaTeX{}'s default for @code{\unitlength} is @code{1pt}.  it is a rigid
+ at LaTeX{}'s default for @code{\unitlength} is @code{1pt}.  It is a rigid
 length (@pxref{Lengths}).  Change it with the @code{\setlength} command
 (@pxref{\setlength}).  Make this change only outside of a @code{picture}
 environment.
@@ -6231,12 +6235,12 @@
 The @code{picture} environment supports using standard arithmetic
 expressions as well as numbers.
 
-Coordinates are given with respect to an origin, which is normally at
+Coordinates are given with respect to an origin, which is by default at
 the lower-left corner of the picture.  Note that when a position appears
 as an argument, as with @code{\put(1,2)@{...@}}, it is not enclosed in
 braces since the parentheses serve to delimit the argument.  Also,
 unlike in some computer graphics systems, larger y-coordinates are
-further up the page.
+further up the page, ie.@: @math{y = 1} is @emph{above} @math{y = 0}.
 
 There are four ways to put things in a picture: @code{\put},
 @code{\multiput}, @code{\qbezier}, and @code{\graphpaper}.  The most
@@ -6289,10 +6293,10 @@
 @end example
 
 @noindent
-The red at tie{}X will be precisely a quarter of the @code{\linewidth} from
-the left margin, and @code{0.35\linewidth} up from the bottom.  Another
-example of this usage is to put similar code in the page header to get
-repeat material on each of a document's pages.
+The red at tie{}X will be precisely a quarter of the @code{\textwidth} from
+the left margin, and @code{0.35\textwidth} up from the bottom of the
+picture.  Another example of this usage is to put similar code in the
+page header to get repeat material on each of a document's pages.
 
 @menu
 * \put::                Place an object at a specified place.



More information about the latexrefman-commits mailing list.