[latexrefman-commits] r501 - in /trunk: ChangeLog latex2e-fr.texi latex2e.texi

[vincent.b.1 at domain.hid]

Author: vincentb1
Date: Fri Feb  5 13:10:41 2016
New Revision: 501

URL: http://svn.gna.org/viewcvs/latexrefman?rev=501&view=rev
Log:
Add node \discretionary.

* latex2e.texi (Line breaking, \discretionary): Add node
\discreionary, need completion.
(\protect): `they must be' -> `one solution is', as there are
alternative solution consisting in robustification of fragile
command. Move concept index entry "moving arguments" next to
concept first occurrence. Fix typo.

* latex2e-fr.texi (Line breaking, \discretionary): Add \discretionary node
(\linebreak & \nolinebreak): Translate this node.
(Page breaking): Translate this node.
(\protect): Translate this node, with same changes as in latex2e.texi

Modified:
    trunk/ChangeLog
    trunk/latex2e-fr.texi
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=501&r1=500&r2=501&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Fri Feb  5 13:10:41 2016
@@ -1,3 +1,17 @@
+2016-02-05  Vincent Belaïche  <vincentb1 at domain.hid>
+
+	* latex2e.texi (Line breaking, \discretionary): Add node
+	\discreionary, need completion.
+	(\protect): `they must be' -> `one solution is', as there are
+	alternative solution consisting in robustification of fragile
+	command. Move concept index entry "moving arguments" next to
+	concept first occurrence. Fix typo.
+
+	* latex2e-fr.texi (Line breaking, \discretionary): Add \discretionary node
+	(\linebreak & \nolinebreak): Translate this node.
+	(Page breaking): Translate this node.
+	(\protect): Translate this node, with same changes as in latex2e.texi.
+
 2016-02-04  Vincent Belaïche  <vincentb1 at domain.hid>
 
 	* latex2e-fr.texi (Spacing in math mode):  Add @xref{\thinspace} to

Modified: trunk/latex2e-fr.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e-fr.texi?rev=501&r1=500&r2=501&view=diff
==============================================================================
--- trunk/latex2e-fr.texi	(original)
+++ trunk/latex2e-fr.texi	Fri Feb  5 13:10:41 2016
@@ -3947,6 +3947,7 @@
 * \obeycr & \restorecr:: Faire que chaque ligne d'entrée commence une nouvelle ligne de sortie.
 * \newline:: Sauter à la ligne
 * \- (césure): \- (hyphenation). Insérer une césure explicite.
+* \discretionary:: Insérer une crésure explicite en contrôlant le caractère d'union.
 * \fussy:: Être pointilleux sur le passage à la ligne.
 * \sloppy:: Être tolérant sur le passage à la ligne.
 * \hyphenation:: Dire à @LaTeX{} comment gérer la césure d'un mot.
@@ -4060,6 +4061,62 @@
 avoir de césure qu'à ces endroit et non dans aucun des points de césure
 que @LaTeX{} aurait pu choisir sinon.
 
+ at node \discretionary
+ at section @code{\discretionary} (césure à gré avec contrôle de l'union)
+ at cindex crésure, discrétionnaire
+ at cindex discrétionnaire, césure
+
+Synopsis :
+
+ at example
+\discretionary at domain.hid}@}
+ at end example
+
+La commande @code{\discretionary} permet de contrôler finement la césure
+dans les cas où ne suffisent ni le contrôle standard de la césure fait
+l'algorithme de césure de @TeX{} et les règles de césures donnés par les
+paquetages de gestion linguistiques, ni les moyens de contrôle
+explicites offerts par les commandes @code{\hyphenation}
+(@pxref{\hyphenation}) et @code{\-} (@pxref{\- (hyphenation),\- (césure
+à gré)}).
+
+ at code{\discretionary} indique qu'un saut de ligne est possible à cet
+endroit. Dans le cas d'un saut de ligne, le texte @var{avant-saut} est
+placé immédiatement avant le saut, et le texte @var{après-saut}
+immédiatement après. Dans le cas sans saut de ligne le texte
+ at var{sans-saut} est imprimé.
+
+Les arguments de @code{\discretionary} ne peuvent contrenir que des
+caractères, des boîtes ou des crénages.
+
+L'usage typique de @code{\discretionary} est par exemple de contrôler la
+césure au sein d'une formule mathématique en mode ligne (voir aussi
+ at ref{Math miscellany,Miscellanées mathématique (entrée \*)}). Ci-dessous
+un exemple de contrôle de la césure au sein d'une adresse réticulaire,
+où l'on autorise la césure sur les obliques mais en utilisant une
+contr'oblique violette en lieu de trait d'union :
+
+ at example
+\documentclass at domain.hid@}
+\usepackage[T1]@{fontenc@}
+\usepackage[utf8]@{inputenc@}
+\usepackage at domain.hid@}
+\usepackage at domain.hid@}
+\usepackage at domain.hid@}
+\newcommand*\DiscrSlash at domain.hid 
+ @{purple at domain.hid@}@}@}@{/@}@{/@}@}
+\begin at domain.hid@}
+Allez donc à \href at domain.hid%
+  /mais/vraiment/tr\%c3\%A8s/longue/adresse/r\%C3\%A9ticulaire%
+  /index.html at domain.hid très\DiscrSlash très\DiscrSlash
+  longue\DiscrSlash mais\DiscrSlash vraiment\DiscrSlash
+  très\DiscrSlash longue\DiscrSlash adresse\DiscrSlash
+  réticulaire\DiscrSlash index.html@}
+\end at domain.hid@}
+ at end example
+
+
+
 
 @node \fussy
 @section @code{\fussy}
@@ -4110,37 +4167,39 @@
 
 @node \linebreak & \nolinebreak
 @section @code{\linebreak} & @code{\nolinebreak}
- at domain.hid @findex \linebreak
- at domain.hid @findex \nolinebreak
- at domain.hid @cindex line breaks, forcing
- at domain.hid @cindex line breaks, preventing
- at domain.hid 
- at domain.hid Synopsis :
- at domain.hid 
- at domain.hid @example
- at domain.hid \linebreak[@var{priority}]
- at domain.hid \nolinebreak[@var{priority}]
- at domain.hid @end example
- at domain.hid 
- at domain.hid By défaut, the @code{\linebreak} (@code{\nolinebreak}) commande forces
- at domain.hid (prevents) a line break at the current position. pour
- at domain.hid @code{\linebreak}, the espaces in the line are stretched out so that it
- at domain.hid extends to the right margin as usual.
- at domain.hid 
- at domain.hid Avec l'argument optionnel @var{priority}, you can convert la commande
- at domain.hid from a demand to a request. The @var{priority} must be a nombre from
- at domain.hid 0 to at domain.hid. The higher the nombre, the more insistent the request.
- at domain.hid 
- at domain.hid 
+ at findex \linebreak
+ at findex \nolinebreak
+ at cindex sauts de ligne, forcer
+ at cindex sauts de ligne, empêcher
+
+Synopsis :
+
+ at example
+\linebreak[@var{priorité}]
+\nolinebreak[@var{priorité}]
+ at end example
+
+Par défaut, la commande @code{\linebreak} (@code{\nolinebreak}) force
+(empêche) un saut de ligne à la position courante.  Pour
+ at code{\linebreak}, les espaces de la ligne sont dilatés jusqu'à ce
+qu'elle s'étende jusqu'à la marge de droite, comme d'habitude.
+
+Avec l'argument optionnel @var{priorité}, vous pouvez convertir la
+commande d'une simple demande à une requête. La @var{priorité} doit être
+un nombre compris entre 0 et 4. Plus ce nombre est grand, et plus la
+requête est insistante.
+
+
 @node Page breaking
- at domain.hid Rupture de page
- at domain.hid @cindex page breaking
- at domain.hid @cindex breaking pages
- at domain.hid 
- at domain.hid @LaTeX{} starts new pages asynchronously, when enough material has
- at domain.hid accumulated to fill up a page. Usually this happens automatiquement,
- at domain.hid but sometimes you may want to influence the breaks.
- at domain.hid 
+ at chapter Saut de page
+ at cindex saut de page
+ at cindex pages, saut
+
+ at LaTeX{} commence de nouvelles pages de façon asynchrone, lorsque
+suffisamment de matériel a été accumulé pour remplir une
+page. D'ordinaire ceci se produit automatiquement, mais parfois on peut
+désirer influencer les sauts.
+
 @menu
 * \cleardoublepage:: Commence une nouvelle page de droite.
 * \clearpage:: Commence une nouvelle page.
@@ -5029,35 +5088,72 @@
 
 @node \protect
 @section @code{\protect}
- at domain.hid @findex \protect
- at domain.hid 
- at domain.hid @cindex fragile commandes
- at domain.hid @cindex moving arguments
- at domain.hid Footnotes, line breaks, any commande that has an optionnel argument, and
- at domain.hid many more are so-called @dfn{fragile} commandes. When a fragile
- at domain.hid commande is used in certain contexts, called @dfn{moving arguments}, it
- at domain.hid must be preceded by @code{\protect}. In addition, any fragile
- at domain.hid commandes within les arguments must have their own @code{\protect}.
- at domain.hid 
- at domain.hid Some exemples of moving arguments are @code{\caption}
- at domain.hid (@pxref{figure}), @code{\thanks} (@pxref{\maketitle}), and
- at domain.hid @-expressions in @code{tabular} and environnement @code{array}s
- at domain.hid (@pxref{tabular}).
- at domain.hid 
- at domain.hid @cindex robust commandes
- at domain.hid Commandes which are not fragile are called @dfn{robust}. They must not
- at domain.hid be preceded by @code{\protect}.
- at domain.hid 
- at domain.hid Voir aussi:
- at domain.hid 
- at domain.hid @smallexample
- at domain.hid @exdent @url{http://www-h.eng.cam.ac.uk/help/tpl/textprocessing/teTeX/latex/latex2e-html/fragile.html}
- at domain.hid @exdent @url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=protect}
- at domain.hid @end smallexample
- at domain.hid 
- at domain.hid @c xx really need exemples.
- at domain.hid 
- at domain.hid 
+ at findex \protect
+
+ at cindex commandes fragiles
+ at cindex commandes robustes
+ at cindex fragile, commande
+ at cindex robuste, commande
+
+Toutes les commandes de @LaTeX{} sont soit @dfn{fragiles} soit
+ at dfn{robustes}. Les notes en bas de page, les saut de ligne, toute
+commande prenant un argument optionnel, et bien d'autres, sont
+fragiles. Une commande fragile peut se disloquer et causer une erreur
+lorsque elle est utilisée au sein de l'argument de certaines
+commandes. Pour empécher la dislocation de ces commandes l'une des
+solutions est de les précéder de la commande @code{\protect}.
+
+Par exemple, lorsque @LaTeX{} execute la commande
+ at code{\section at domain.hid}@}} il écrit le texte
+ at var{nom-rubrique} dans le fichier auxiliaire @file{.aux}, de sorte à 
+pouvoir le tirer de là pour l'utiliser dans d'autres partie du document
+comme la table des matières. On appelle 
+ at cindex arguments mobiles
+ at dfn{argument mobile} tout argument qui est développé en interne par
+ at LaTeX{} sans être directement composé en sortie. Une commande est dite
+fragile si elle se développe pendant ce processus en un code @TeX{} non
+valide. Certains exemples d'arguments mobiles sont ceut qui apparaissent
+au sein des commande @code{\caption@{...@}} (@pxref{figure}), dans la
+commande @code{\thanks@{...@}} (@pxref{\maketitle}), et dans les
+expression en @@ des environnements @code{tabular} et @code{array}
+(@pxref{tabular}).
+
+Si vous obtenez des erreurs étranges de commandes utilisées au sein
+d'arguments mobiles, essayez des les précéder d'un @code{\protect}. Il
+faut un @code{\protect} pour chacune des commandes fragiles.
+
+Bien qu'en général la commande @code{\protect} ne fait pas de mal, les
+commandes de gestion de longueurs sont robustes et ne devraient pas être
+précédées d'une commande @code{\protect}. Une commande @code{\protect}
+ne peut pas non plus être utilisée au sein de l'argument d'une commande
+ at ref{\addtocounter, at code{\addtocounter}} ou
+ at ref{\setcounter, at code{\setcounter}}.
+
+Dans l'exemple qui suit la commande @code{\caption} produit une erreur
+mystérieuse
+
+ at example
+\begin at domain.hid@}
+  ...
+  \caption at domain.hid headquarters of A\raisebox at domain.hid@}@}
+\end at domain.hid@}
+ at end example
+
+Dans l'exemple suivant la commande @code{\tableofcontents} produit une
+erreur à cause du @code{\(..\)} dans le titre de section qui se
+développe en code  incorrect @TeX{} dans le fichier @file{.toc}.  Vous
+pouvez résoudre ceci en remplaçat  @code{\(..\)}
+par @code{\protect\(..\protect\)}.
+
+ at example
+\begin at domain.hid@}
+\tableofcontents
+...
+\section at domain.hid \( e=mc^2 \)@}
+...
+ at end example
+
+
 @node Counters
 @chapter Compteurs
 @cindex compteurs, a list of

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=501&r1=500&r2=501&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Fri Feb  5 13:10:41 2016
@@ -4522,6 +4522,7 @@
 * \obeycr & \restorecr::       Make each input line start a new output line.
 * \newline::                   Break the line
 * \- (hyphenation)::           Insert explicit hyphenation.
+* \discretionary::             Insert explicit hyphenation with control of hyphen character.
 * \fussy::                     Be fussy about line breaking.
 * \sloppy::                    Be sloppy about line breaking.
 * \hyphenation::               Tell @LaTeX{} how to hyphenate a word.
@@ -4630,6 +4631,18 @@
 hyphenated at those points and not at any of the hyphenation points
 that @LaTeX{} might otherwise have chosen.
 
+ at node \discretionary
+ at section @code{\discretionary} (hyphenation on demand with controlable hyphen charactère)
+ at cindex hyphenation, discretionary
+ at cindex discretionary hyphenation
+
+Synopsis:
+
+ at example
+\discretionary at domain.hid}@}
+ at end example
+
+ at c xxx TODO, complete this node, see LaTeX-fr
 
 @node \fussy
 @section @code{\fussy}
@@ -5655,20 +5668,22 @@
 @findex \protect
 @cindex fragile commands
 @cindex robust commands
- at domain.hid moving arguments
 
 All @LaTeX{} commands are either @dfn{fragile} or @dfn{robust}.
 Footnotes, line breaks, any command that has an optional argument, and
 many more, are fragile.  A fragile command can break when it is used in
 the argument to certain commands.  To prevent such commands from
-breaking they must be preceded by the command @code{\protect}.
+breaking one solution is to have them preceded by the command
+ at code{\protect}.
 
 For example, when @LaTeX{} runs the @code{\section at domain.hid
 name}@}} command it writes the @var{section name} text to the
 @file{.aux} auxiliary file, moving it there for use elsewhere in the
 document such as in the table of contents.  Any argument that is
 internally expanded by @LaTeX{} without typesetting it directly is
-referred to as a @dfn{moving argument}.  A command is fragile if it can
+referred to as a 
+ at cindex moving arguments
+ at dfn{moving argument}.  A command is fragile if it can
 expand during this process into invalid @TeX{} code.  Some examples of
 moving arguments are those that appear in the @code{\caption@{...@}}
 command (@pxref{figure}), in the @code{\thanks@{...@}} command
@@ -5684,7 +5699,7 @@
 command. Nor can a @code{\protect} command be used in the argument to
 @code{\addtocounter} or @code{\setcounter} command.
 
-In this example the @code{caption} command gives a mysterious error
+In this example the @code{\caption} command gives a mysterious error
 about an extra curly brace.  Fix the problem by preceding each
 @code{\raisebox} command with @code{\protect}.