man nl (Commandes) - Numéroter les lignes d'un fichier.

NOM

nl - Numéroter les lignes d'un fichier.

SYNOPSIS

nl [-h type_en_tête] [-b type_corps] [-f type_pied_page] [-p] [-d cc] [-v numéro_départ] [-i incrément] [-l lignes] [-s séparateur_lignes] [-w largeur_numéros] [-n {ln,rn,rz}] [--header-numbering=style] [--body-numbering=style] [--footer-numbering=style] [--first-page=nombre] [--page-increment=nombre] [--no-renumber] [--join-blank-lines=nombre] [--number-separator=chaîne] [--number-width=nombre] [--number-format={ln,rn,rz}] [--section-delimiter=cc] [--help] [--version] [fichier...]

DESCRIPTION

Cette page de manuel documente la version GNU de nl.

nl copie les fichiers indiqués sur la sortie standard en ajoutant des numéros à toutes les lignes, ou à certaines d'entre-elles.

Si aucun nom de fichier n'est fourni, ou si le nom `-' est mentionné, l'entrée standard sera copiée.

nl considère que ses entrées sont composées de pages. Par défaut, le numéro de ligne est réinitialisé à 1 au début de chaque page. nl traite tous ses fichiers d'entrée comme un unique document. Il ne réinitialise pas les numéros de ligne ou de page entre les fichiers.

Une page est composée de 3 sections : un en-tête, un corps, et un pied de page. Chacune de ces sections peut éventuellement être vide. Chacune peut également être numérotée de manière différente des autres.

Le début des sections de chaque page est indiqué dans le fichier d'entrée par une ligne ne contenant qu'une chaîne de délimitation comme suit :

\:\:\: début de l'en-tête \:\: début du corps de la page \: début du pied de page

Les deux caractères utilisés pour ces chaînes peuvent être modifiés par une option indiquée plus bas, mais l'organisation et la longueur des chaînes sont figées.

Les chaînes de délimitation des sections sont remplacées par des lignes vides en sortie. Tout texte rencontré avant le délimiteur de début d'en-tête est considéré comme appartenant au corps de la page. Ainsi, un texte ne contenant aucun délimiteur sera considéré comme une unique section "corps de page".

OPTIONS

-h, --header-numbering=style
Voir --footer-numbering.
-b, --body-numbering=style
Voir --footer-numbering.
-f, --footer-numbering=style
Choisit le type de numérotation pour les lignes de la section "pied-de-page" de chaque page logique. Quand une ligne n'est pas numérotée, le numéro de ligne n'est pas incrémenté, mais le caractère séparateur de numéro de ligne est quand même ajouté à celle-ci. Les styles possibles sont :
a
numéroter toutes les lignes
t
ne numéroter que les lignes non-vide (comportement par défaut pour le corps de page)
n
ne pas numéroter les lignes (comportement par défaut pour les en-têtes et les pieds de page)
pregexp
ne numéroter que les lignes contenant une correspondance avec l'expression rationnelle regexp
-p, --no-renumber
Ne pas réinitialiser la numérotation en début de page
-v, --first-page=valeur
Démarrer en début de page la numérotation à la valeur indiquée (par défaut : 1).
-i, --page-increment=valeur
Incrémenter les numéros de ligne de la valeur indiquée (par défaut 1).
-l, --join-blank-lines=nombre
Considérer que nombre (par défaut 1) lignes vides consécutives représentent une seule ligne logique pour la numérotation. Seule la dernière ligne sera numérotée. Quand il y a moins de nombre lignes vides consécutives, ne pas les numéroter. Une ligne vide ne doit contenir aucun caractère, pas même d'espaces ou de tabulations.
-s, --number-separator=chaîne
Séparer, en sortie, le numéro de ligne et le texte de celle-ci avec la chaîne mentionnée (Par défaut, il s'agit du caractère Tabulation).
-w, --number-width=largeur
Formater le numéro de ligne avec la largeur indiquée (par défaut 6 caractères).
-n, --number-format={ln,rn,rz}
Sélection du format de numérotation des lignes :
ln
aligné à gauche, pas de 0 en début de nombre.
rn
aligné à droite, pas de 0 en début de nombre (attitude par défaut).
rz
aligné à droite, complété à gauche par des 0.
-d, --section-delimiter=cc
Utiliser les deux caractères cc mentionnés ici pour les indicateurs de début de sections. Si un seul caractère est fourni, le second conserve la valeur ':'. Pour saisir '\', utiliser '\\'.
--help
Afficher un message d'aide sur la sortie standard et se terminer normalement.
--version
Afficher un numéro de version sur la sortie standard et se terminer normalement.

TRADUCTION

Christophe Blaess, 1997-2003.