25.1.1 \@dottedtocline

Synopsis :

\@dottedtocline{numnivrubrique}{renfoncement}{largeurnum}{texte}{numpage}

Utilisée en interne par LaTeX pour formater une ligne d’article dans la table des matières, table des figures ou table des tableaux. Les auteurs ne saisissent pas directement des commandes \@dottedtocline.

Cette commande est typiquement utilisée par \l@section, \l@subsection, etc., pour formater le contenu de ces tables. Par exemple, le fichier article.cls contient ces définitions :

\newcommand*\l@section{\@dottedtocline{1}{1.5em}{2.3em}}
\newcommand*\l@subsection{\@dottedtocline{2}{3.8em}{3.2em}}
\newcommand*\l@subsubsection{\@dottedtocline{3}{7.0em}{4.1em}}

Dans cet exemple, on dirait \@dottedcline ne prend que trois argument. Mais en remontant le code on s’aperçoit qu’elle prend également les deux arguments finaux texte et numéro-page du synopsis d’appel de \contentsline (voir \contentsline).

Entre la boîte du texte de titre de rubrique et la marge de droite, ces commandes \@dottedtocline insèrent des points de suite, c.-à-d. une ligne en pointillés uniformément espacés. L’espace inter-point est donné par la commande \@dotsep. Par défaut c’est 4.5 (exprimé en unités de longueur mathématique, ou mu, soit 1/18em. On peut le modifier avec \renewcommand, comme dans \renewcommand{\@dotsep}{3.5}.

Dans la classe standarde book, LaTeX n’utilise pas de points de suite pour articles de la table correspondant aux rubriques de niveau \part ou \chapter, et dans la classe article, il n’en utilise pas pour les articles de niveau \section.