[latexrefman-discuss] node \discretionary

[Vincent Belaïche]

Hello,

I have added this node (latex2e.texi has only the Synopsis, please look
at excerpt from latex2e-fr.texi below --- after reading it again, I made
two fixes compared to commited code.


Comments welcome. Basically I say about \discretionary that:

- it allows fine control of hyphenation where other method do not
  suffice
- then I explain how it works wrt to Synopsis
- then I give restriction on arguments
- then I suggest typical usage and give some funny example.

--8<----8<----8<----8<----8<-- begin -->8---->8---->8---->8---->8----
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ées 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é)}).

@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
@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 paragraphe (voir aussi
@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 :

@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@}
@end example
--8<----8<----8<----8<----8<--  end  -->8---->8---->8---->8---->8----

VBR,
	Vincent