Fichiers dont le contenu doit être ajouté. Les patrons (ex : *.c) permettent de restreindre à tous les fichiers correspondants. Un nom de répertoire (ex : rep pour ajouter rep/fichier1 et rep/fichier2) permet d’ajouter récursivement tous les fichiers d’un répertoire (par exemple spécifier rep n’enregistrera pas seulement le fichier modifié dans l’arbre de travail rep/fichier1 ou un fichier ajouté rep/fichier2, mais aussi un fichier rep/fichier3 supprimé de l’arbre de travail). Veuillez noter que des version anciennes de Git ignoraient les fichiers supprimés ; utilisez l’option --no-all si vous souhaitez ajouter les fichiers nouveaux ou modifiés mais ignorer les fichiers supprimés.

Ne pas ajouter réellement les fichiers. Montrer juste ceux qui existent ou seront ignorés.

Mode bavard.

Permettre l’ajout de fichiers qui sont normalement ignorés.

Autoriser la mise à jour des entrées d’index en dehors du cône d’extraction clairsemée. Normalement, git add refuse de mettre à jour les entrées d’index dont les chemins ne rentrent pas dans le cône d’extraction clairsemée, car ces fichiers pourraient être supprimés de l’arbre de travail sans avertissement. Voir git-sparse-checkout[1] pour plus de détails.

Ajouter le contenu modifié dans l’arbre de travail à l’index. Les arguments optionnels de chemin permettent de limiter les opérations à un sous-ensemble de l’arbre de travail. Référez-vous à « Mode interactif » pour plus de détails.

Choisir de manière interactive les sections de patch entre l’index et la copie de travail et les ajouter à l’index. Cela permet à l’utilisateur de passer en revue les différences avant d’ajouter le contenu modifié à l’index.

Ouvrir les différences avec l’index dans un éditeur et laisser l’utilisateur les éditer. Après la fermeture de l’éditeur, ajuster les entêtes de sections et appliquer le patch à l’index.

Mettre à jour l’index sur les seuls fichiers déjà présents et correspondant à <spec-de-chemin>. Cela retire ou modifie les entrées d’index pour correspondre à la copie de travail, mais n’ajoute pas de fichier.

Mettre à jour l’index non seulement pour tous les fichiers de l’arbre de travail correspondant à <spec-de-chemin> mais aussi pour toutes les entrées existant déjà dans l’index. Ceci ajoute, modifie et retire des entrées d’index pour correspondre à la copie de travail.

Mettre à jour l’index en y ajoutant les nouveaux fichiers qui sont inconnus et les fichiers modifiés dans la copie de travail, mais ignore les fichiers qui ont été effacés de la copie de travail. Cette option ne fait rien quand aucun <spec-de-chemin> n’est utilisé.

N’enregistrer que le fait que le chemin sera ajouté plus tard. Une entrée pour le chemin est placée en index sans contenu. C’est particulièrement utile pour, entre autres choses, montrer le contenu non indexé de ces fichiers avec git diff et les valider avec git commit -a.

Ne pas ajouter le ou les fichiers mais rafraîchir seulement leur information de stat() dans l’index.

Si des fichiers n’ont pas pu être ajoutés à cause d’erreurs lors de leur indexation, ne pas annuler l’opération mais continuer l’ajout des autres fichiers. La commande se terminera tout de même avec un code d’erreur non nul. Le paramètre de configuration add.ignoreErrors peut être positionné à true pour que ce comportement soit celui par défaut.

Cette option ne peut être utilisée que couplée avec --dry-run. L’utilisation de cette option permet à l’utilisateur de vérifier si un des fichiers indiqués serait ignoré, qu’il soit présent ou non dans la copie de travail.

Par défaut, git add avertit l’utilisateur lors de l’ajout d’un dépôt embarqué dans l’index sans utilisation de git submodule add pour créer une entrée dans .gitmodules. Cette option supprime cet avertissement (par exemple, si vous effectuez manuellement des opérations sur des sous-modules).

Forcer l’application du filtre "clean" à tous les fichiers suivis pour les ajouter en force à l’index. C’est utile après avoir changé la variable de configuration core.autocrlf ou l’attribut text pour corriger des fichiers ajoutés avec des fins de lignes erronées CRLF/LF. Cette option implique -u. Les caractères CR solitaires ne sont pas traités, donc alors qu’un CRLF est nettoyé en LF, une séquence CRCRLF n’est que partiellement nettoyée en CRLF.

Forcer le bit exécutable des fichiers ajoutés. Le bit exécutable n’est modifié que dans l’index, les fichiers de la copie de travail ne sont pas modifiés.

Le spécificateur de chemin est passé dans <fichier> au lieu des arguments de la ligne de commande. Si <fichier> vaut - alors l’entrée standard est utilisée. Les éléments du spécificateur de chemin sont séparés par LF ou CR/LF. Les éléments du spécificateur de chemin peuvent être cités comme expliqué pour la variable de configuration core.quotePath (voir git-config[1]). Voir aussi l’option --pathspec-file-nul et l’option globale --literal-pathspecs.

Uniquement significatif avec --pathspec-from-file. Les éléments du spécificateur de chemin sont séparés par le caractère NUL et tous les autres caractères sont utilisés littéralement (y compris les retours à la ligne et les guillemets).

Cette option permet de séparer les options de la ligne de commande de la liste des fichiers (utile si certains noms de fichiers peuvent être confondus avec des options).

Ceci affiche les modifications entre HEAD et l’index (c-à-d ce qui seraient validées si vous lanciez git commit), et entre l’index et les fichiers de la copie de travail (c-à-d ce que vous pourriez indexer au moyen de git add avant de lancer git commit) pour chaque chemin. Un exemple d’affichage ressemble à ceci :

              staged     unstaged path
     1:       binary      nothing foo.png
     2:     +403/-35        +1/-1 add-interactive.c

Ceci affiche l’information d’état et une invite "Update>>". Quand l’invite se termine par un double >, vous pouvez sélectionner plus d’une option, concaténées avec des espaces ou des virgules. Vous pouvez aussi indiquer des intervalles. Par exemple "2-5 7,9" pour choisir 2, 3, 4, 5, 7 et 9 dans la liste. Si le second nombre d’un intervalle est absent, tous les patchs restants sont sélectionnés. Par ex. "7-" choisit 7, 8 et 9 dans la liste. * permet de tout sélectionner.

           staged     unstaged path
  1:       binary      nothing foo.png
* 2:     +403/-35        +1/-1 add-interactive.c

Update>> -2

Ceci présente une interface d’utilisation similaire à update, et les informations indexées des chemins sélectionnés sont ramenées à la version HEAD. Restaurer des chemins nouveaux les rend non-suivis.

Ceci présente une interface d’utilisation très similaire à update et revert et permet d’ajouter des chemins non-suivis à l’index.

Ceci permet de choisir un chemin depuis une sélection similaire à status. Après le choix du chemin, la différence entre l’index et le fichier dans l’arbre de travail est présentée et il vous est demandé si vous souhaitez indexer chaque section de modification. Vous pouvez sélectionner une des options suivantes et taper Entrée :

y - stage this hunk
n - do not stage this hunk
q - quit; do not stage this hunk or any of the remaining ones
a - stage this hunk and all later hunks in the file
d - do not stage this hunk or any of the later hunks in the file
g - select a hunk to go to
/ - search for a hunk matching the given regex
j - leave this hunk undecided, see next undecided hunk
J - leave this hunk undecided, see next hunk
k - leave this hunk undecided, see previous undecided hunk
K - leave this hunk undecided, see previous hunk
s - split the current hunk into smaller hunks
e - manually edit the current hunk
p - print the current hunk
? - print help

Ceci permet de faire une revue de ce qui sera validé (c’est une différence entre HEAD et index).