Git 🌙
Français ▾ Topics ▾ Latest version ▾ git-check-ignore last updated in 2.43.0

NOM

git-check-ignore - DĂ©bogue les fichiers gitignore / exclude

SYNOPSIS

git check-ignore [<options>] <nom-de-chemin>…​
git check-ignore [<options>] --stdin

DESCRIPTION

Pour chaque nom de chemin donnĂ© via la ligne de commande ou depuis un fichier via --stdin, vĂ©rifie si le fichier est exclu par .gitignore (ou d’autres fichiers d’entrĂ©e du mĂ©canisme d’exclusion) et affiche le chemin s’il est exclu.

Par dĂ©faut, les fichiers suivis ne sont pas affichĂ©s du tout puisqu’ils ne sont pas soumis aux règles d’exclusion ; mais voyez ‘--no-index’.

OPTIONS

-q, --quiet

Ne pas Ă©mettre de message, dĂ©finir juste le statut de sortie. Ceci n’est valable qu’avec un seul chemin d’accès.

-v, --verbose

Au lieu d’afficher les chemins qui sont exclus, pour chaque chemin qui correspond Ă  un motif d’exclusion, imprimer le motif d’exclusion avec le chemin. (La correspondance d’un motif d’exclusion signifie gĂ©nĂ©ralement que le chemin est exclu, mais si le motif commence par "!", il s’agit alors d’un motif nĂ©gatif et sa correspondance signifie que le chemin n’est PAS exclu).

Pour les règles de prĂ©sĂ©ance dans et entre les sources d’exclusion, voir gitignore[5].

--stdin

Lire les noms de chemin depuis l’entrĂ©e standard, un par ligne, au lieu de la ligne de commande.

-z

Le format de sortie est modifiĂ© pour ĂŞtre analysable par une machine. Si --stdin est Ă©galement donnĂ©, les chemins d’entrĂ©e sont sĂ©parĂ©s par un caractère NUL au lieu d’un caractère de saut de ligne.

-n, --non-matching

Afficher les chemins donnĂ©s qui ne correspondent Ă  aucun motif. Cela n’a de sens que si --verbose est activĂ©, sinon il ne serait pas possible de distinguer les chemins qui correspondent Ă  un motif de ceux qui ne le correspondent pas.

--no-index

Ne pas regarder dans l’index lors des vĂ©rifications. Cela peut ĂŞtre utilisĂ© pour dĂ©boguer la raison pour laquelle un chemin est devenu suivi par exemple par git add . et n’a pas Ă©tĂ© ignorĂ© par les règles comme prĂ©vu par l’utilisateur ou lors du dĂ©veloppement de motifs incluant la nĂ©gation pour correspondre Ă  un chemin prĂ©cĂ©demment ajoutĂ© avec git add -f.

SORTIE

Par défaut, tous les noms de chemin donnés qui correspondent à un motif négatif seront affichés, un par ligne. Si aucun motif ne correspond à un chemin donné, rien ne sera affiché pour ce chemin ; cela signifie que ce chemin ne sera pas ignoré.

Si --verbose est spécifié, la sortie est une série de lignes de la forme :

<source> <DEUX-POINTS> <num-ligne> <DEUX-POINTS> <motif> <HT> <nom-de-chemin>

<nom-de-chemin> est le chemin d’un fichier interrogĂ©, <motif> est le motif correspondant, <source> est le fichier source du motif, et <num-ligne> est le numĂ©ro de ligne du motif dans cette source. Si le motif contenait un prĂ©fixe "!" ou un suffixe "/", il sera prĂ©servĂ© dans la sortie. <source> sera un chemin absolu quand il se rĂ©fère au fichier configurĂ© par core.excludesFile, ou relatif Ă  la racine du dĂ©pĂ´t quand il se rĂ©fère Ă  .git/info/exclude ou Ă  un fichier d’exclusion par rĂ©pertoire.

Si -z est spécifié, les noms de chemin dans la sortie sont délimités par le caractère nul ; si --verbose est également spécifié, les caractères nuls sont également utilisés à la place des deux-points et des tabulations :

<source> <NULL> <num-ligne> <NULL> <motif> <NULL> <nome-de-chemin> <NULL>

Si -n ou --non-matching sont spĂ©cifiĂ©s, les noms de chemin non-matching seront aussi sortis, dans ce cas tous les champs dans chaque enregistrement de sortie sauf pour <nom-de-chemin> seront vides. Cela peut ĂŞtre utile lors d’une exĂ©cution non-interactive, de sorte que les fichiers peuvent ĂŞtre envoyĂ©s incrĂ©mentalement sur STDIN d’un processus check-ignore au long cours, et pour chacun de ces fichiers, STDOUT indiquera si ce fichier correspond Ă  un motif ou non. (Sans cette option, il serait impossible de dire si l’absence de sortie pour un fichier donnĂ© signifie qu’il ne correspond Ă  aucun motif, ou que la sortie n’a pas encore Ă©tĂ© gĂ©nĂ©rĂ©e).

La mise en mĂ©moire tampon se fait comme documentĂ© sous l’option GIT_FLUSH dans git[1]. L’appelant Ă  la charge d’Ă©viter les blocages causĂ©s par le remplissage excessif d’un tampon d’entrĂ©e ou la lecture d’un tampon de sortie vide.

STATUT DE SORTIE

0

Un ou plusieurs des chemins fournis sont ignorés.

1

Aucun des chemins fournis n’est ignorĂ©.

128

Une erreur fatale a été rencontrée.

GIT

Fait partie de la suite git[1]

TRADUCTION

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .

scroll-to-top