git-add - En ligne dans le Cloud

PROGRAMME:

Nom

git-add - Ajoute le contenu du fichier à l'index

SYNOPSIS

jet ajouter [--verbeux | -v] [--dry-run | -n] [--force | -f] [--interactif | -i] [--patch | -p]
[--modifier | -e] [--[no-]all | --[no-]ignore-suppression | [--mise à jour | -u]]
[--intention-d'ajouter | -N] [--refresh] [--ignore-errors] [--ignore-missing]
[--] [ ...]

DESCRIPTION

Cette commande met à jour l'index en utilisant le contenu courant trouvé dans l'arbre de travail, pour
préparer le contenu mis en scène pour le prochain commit. Il ajoute généralement le contenu actuel de
chemins existants dans leur ensemble, mais avec certaines options, il peut également être utilisé pour ajouter du contenu avec
seulement une partie des modifications apportées aux fichiers de l'arbre de travail appliqué, ou supprimer les chemins qui ne
n'existe plus dans l'arbre de travail.

L'"index" contient un instantané du contenu de l'arbre de travail, et c'est cet instantané
qui est pris comme contenu du prochain commit. Ainsi, après avoir apporté des modifications au
arbre de travail, et avant d'exécuter la commande commit, vous devez utiliser la commande add pour ajouter
tous les fichiers nouveaux ou modifiés à l'index.

Cette commande peut être exécutée plusieurs fois avant un commit. Il ajoute seulement le contenu de
le(s) fichier(s) spécifié(s) au moment de l'exécution de la commande add ; si vous souhaitez des modifications ultérieures
inclus dans le prochain commit, vous devez alors réexécuter git add pour ajouter le nouveau contenu au
indice.

La commande git status peut être utilisée pour obtenir un résumé des fichiers ayant des modifications qui
sont mis en scène pour le prochain commit.

La commande git add n'ajoutera pas de fichiers ignorés par défaut. Si des fichiers ignorés étaient
explicitement spécifié sur la ligne de commande, git add échouera avec une liste de fichiers ignorés.
Fichiers ignorés atteints par récursivité de répertoire ou globalisation de nom de fichier effectuée par Git (citation
vos globs avant le shell) seront ignorés en silence. Les jet ajouter la commande peut être utilisée pour
ajouter des fichiers ignorés avec l'option -f (forcer).

S'il te plait regarde git-commit(1) pour d'autres moyens d'ajouter du contenu à un commit.

OPTIONS

...
Fichiers à partir desquels ajouter du contenu. Des Fileglobs (par exemple *.c) peuvent être donnés pour ajouter toutes les correspondances
des dossiers. De plus, un nom de répertoire principal (par exemple dir pour ajouter dir/file1 et dir/file2) peut être
donné pour mettre à jour l'index pour qu'il corresponde à l'état actuel du répertoire dans son ensemble (par exemple
spécifier dir enregistrera non seulement un fichier dir/file1 modifié dans l'arbre de travail, un
fichier dir/file2 ajouté à l'arborescence de travail, mais aussi un fichier dir/file3 supprimé du
arbre de travail. Notez que les anciennes versions de Git ignoraient les fichiers supprimés ; utilisation
--no-all option si vous souhaitez ajouter des fichiers modifiés ou nouveaux mais ignorer ceux supprimés.

-n, --exécution à sec
N'ajoutez pas réellement le(s) fichier(s), montrez simplement s'ils existent et/ou seront ignorés.

-v, --verbeux
Soyez verbeux.

-f, --force
Autoriser l'ajout de fichiers autrement ignorés.

-i, --interactif
Ajoutez le contenu modifié dans l'arbre de travail de manière interactive à l'index. Chemin facultatif
des arguments peuvent être fournis pour limiter l'opération à un sous-ensemble de l'arbre de travail. Voir
« Mode interactif » pour plus de détails.

-p, --patch
Choisissez de manière interactive des morceaux de patch entre l'index et l'arbre de travail et ajoutez-les
à l'indice. Cela donne à l'utilisateur la possibilité d'examiner la différence avant d'ajouter
contenu modifié à l'index.

Cela exécute efficacement add --interactive, mais contourne le menu de commande initial et
passe directement à la sous-commande patch. Voir « Mode interactif » pour plus de détails.

-e, --edit
Ouvrez le diff par rapport à l'index dans un éditeur et laissez l'utilisateur le modifier. Après l'éditeur
a été fermé, ajustez les en-têtes de morceau et appliquez le correctif à l'index.

Le but de cette option est de choisir les lignes du patch à appliquer, ou même
pour modifier le contenu des lignes à mettre en scène. Cela peut être plus rapide et plus flexible
que d'utiliser le sélecteur de morceau interactif. Cependant, il est facile de se confondre et
créer un correctif qui ne s'applique pas à l'index. Voir MODIFICATION DE PATCHS ci-dessous.

-u, --mise à jour
Mettre à jour l'index là où il a déjà une correspondance d'entrée . Cela supprime
ainsi que modifie les entrées d'index pour correspondre à l'arborescence de travail, mais n'ajoute aucun nouveau fichier.

Sinon est donné lorsque l'option -u est utilisée, tous les fichiers suivis dans l'ensemble
l'arbre de travail sont mis à jour (les anciennes versions de Git servaient à limiter la mise à jour à la version actuelle
répertoire et ses sous-répertoires).

-A, --all, --no-ignore-removal
Mettre à jour l'index non seulement là où l'arbre de travail a un fichier correspondant mais
également où l'index a déjà une entrée. Cela ajoute, modifie et supprime l'index
entrées pour correspondre à l'arbre de travail.

Sinon est donné lorsque l'option -A est utilisée, tous les fichiers de l'arbre de travail entier
sont mis à jour (les anciennes versions de Git limitaient la mise à jour au répertoire courant et
ses sous-répertoires).

--non-tout, --ignore-removal
Mettre à jour l'index en ajoutant de nouveaux fichiers inconnus de l'index et des fichiers modifiés
dans l'arbre de travail, mais ignore les fichiers qui ont été supprimés de l'arbre de travail.
Cette option est un no-op quand aucun est utilisé.

Cette option est principalement destinée à aider les utilisateurs habitués aux anciennes versions de Git, dont
"git ajouter ..." était un synonyme de "git add --no-all ...", c'est à dire
ignoré les fichiers supprimés.

-N, --intention d'ajouter
Enregistrez uniquement le fait que le chemin sera ajouté plus tard. Une entrée pour le chemin est
placé dans l'index sans contenu. Ceci est utile, entre autres, pour montrer
le contenu non mis en scène de ces fichiers avec git diff et leur validation avec git commit
-a.

--rafraîchir
N'ajoutez pas le(s) fichier(s), mais actualisez uniquement leurs informations stat() dans l'index.

--ignore-erreurs
Si certains fichiers n'ont pas pu être ajoutés en raison d'erreurs d'indexation, n'abandonnez pas le
opération, mais continuez à ajouter les autres. La commande doit toujours se terminer avec une valeur différente de zéro
statut. La variable de configuration add.ignoreErrors peut être définie sur true pour que cela
le comportement par défaut.

--ignore-manquant
Cette option ne peut être utilisée qu'avec --dry-run. En utilisant cette option, l'utilisateur
peut vérifier si l'un des fichiers donnés serait ignoré, peu importe s'ils le sont déjà
présent dans l'arbre de travail ou non.

--
Cette option peut être utilisée pour séparer les options de la ligne de commande de la liste des fichiers,
(utile lorsque les noms de fichiers peuvent être confondus avec des options de ligne de commande).

CONFIGURATION

La variable de configuration facultative core.excludesFile indique un chemin vers un fichier
contenant des modèles de noms de fichiers à exclure de git-add, similaire à
$GIT_DIR/info/exclude. Les modèles dans le fichier d'exclusion sont utilisés en plus de ceux dans
info/exclure. Voir gitignore (5).

EXEMPLES

· Ajoute le contenu de tous les fichiers *.txt sous le répertoire Documentation et son
sous-répertoires :

$ git add Documentation/\*.txt

Notez que l'astérisque * est cité à partir du shell dans cet exemple ; cela permet au
La commande inclut les fichiers des sous-répertoires du répertoire Documentation/.

· Envisage d'ajouter du contenu à partir de tous les scripts git-*.sh :

$ git ajouter git-*.sh

Parce que cet exemple permet au shell de développer l'astérisque (c'est-à-dire que vous répertoriez le
explicitement), il ne prend pas en compte subdir/git-foo.sh.

INTERACTIF MODE

Lorsque la commande entre en mode interactif, elle affiche la sortie du statuts
sous-commande, puis passe dans sa boucle de commande interactive.

La boucle de commande affiche la liste des sous-commandes disponibles et affiche une invite « Quoi maintenant > ».
En général, lorsque l'invite se termine par un seul >, vous ne pouvez choisir qu'un seul des choix
donné et tapez return, comme ceci :

*** Commandes ***
1 : statut 2 : mise à jour 3 : retour 4 : ajout non suivi
5 : patch 6 : diff 7 : quitter 8 : aide
Et maintenant> 1

Vous pouvez également dire s ou sta ou status ci-dessus tant que le choix est unique.

La boucle de commande principale a 6 sous-commandes (plus help et quit).

statuts
Cela montre le changement entre HEAD et index (c'est-à-dire ce qui sera validé si vous dites
git commit), et entre les fichiers d'index et d'arbre de travail (c'est-à-dire ce que vous pourriez mettre en scène
plus loin avant git commit en utilisant git add) pour chaque chemin. Un exemple de sortie ressemble à
ce:

chemin non mis en scène
1: rien binaire foo.png
2 : +403/-35 +1/-1 git-add--interactive.perl

Cela montre que foo.png a des différences avec HEAD (mais c'est binaire donc le nombre de lignes
ne peut pas être affiché) et il n'y a pas de différence entre la copie indexée et l'arbre de travail
version (si la version de l'arbre de travail était également différente, binaire aurait été montré
au lieu de rien). L'autre fichier, git-add--interactive.perl, a 403 lignes ajoutées
et 35 lignes supprimées si vous validez ce qui est dans l'index, mais le fichier d'arbre de travail a
modifications supplémentaires (un ajout et une suppression).

Mise à jour
Cela affiche les informations d'état et émet une invite "Mise à jour>>". Lorsque l'invite
se termine par un double >>, vous pouvez effectuer plusieurs sélections, concaténées avec
espace ou virgule. Vous pouvez aussi dire des plages. Par exemple "2-5 7,9" pour choisir 2,3,4,5,7,9
de la liste. Si le deuxième nombre d'une plage est omis, tous les patchs restants sont
pris. Par exemple "7-" pour choisir 7,8,9 dans la liste. Tu peux dire * de tout choisir.

Ce que vous avez choisi est ensuite mis en évidence avec *, Comme ceci:

chemin non mis en scène
1: rien binaire foo.png
* 2 : +403/-35 +1/-1 git-add--interactive.perl

Pour supprimer la sélection, préfixez l'entrée avec - comme ceci :

Mise à jour>> -2

Après avoir fait la sélection, répondez par une ligne vide pour mettre en scène le contenu du travail
fichiers arborescents pour les chemins sélectionnés dans l'index.

revenir
Cela a une interface utilisateur très similaire à Mise à jour, et les informations mises en scène pour les chemins sélectionnés
sont ramenés à celui de la version HEAD. L'inversion de nouveaux chemins les rend non suivis.

ajouter non suivi
Cela a une interface utilisateur très similaire à Mise à jour ainsi que revenir, et vous permet d'ajouter des chemins non suivis à
l'index.

pièce
Cela vous permet de choisir un chemin parmi un statuts comme la sélection. Après avoir choisi le chemin,
il présente la différence entre l'index et le fichier arbre de travail et vous demande si vous
veulent mettre en scène le changement de chaque beau gosse. Vous pouvez sélectionner l'une des options suivantes et
tapez retour :

y - mettre en scène ce beau gosse
n - ne mets pas en scène ce beau gosse
q - quitter ; ne mets pas en scène ce morceau ou l'un des autres
a - mettre en scène ce morceau et tous les morceaux ultérieurs dans le fichier
d - ne mettez pas en scène ce morceau ou l'un des derniers morceaux du fichier
g - sélectionnez un morceau vers lequel aller
/ - recherche d'un morceau correspondant à la regex donnée
j - laisser ce morceau indécis, voir le prochain morceau indécis
J - laisse ce morceau indécis, voir le prochain morceau
k - laisser ce morceau indécis, voir le morceau indécis précédent
K - laisser ce morceau indécis, voir le morceau précédent
s - diviser le morceau actuel en morceaux plus petits
e - modifier manuellement le morceau actuel
? - aide à l'impression

Après avoir décidé du sort de tous les mecs, s'il y a un mec qui a été choisi, l'index
est mis à jour avec les morceaux sélectionnés.

Vous pouvez éviter d'avoir à taper return ici, en définissant la variable de configuration
interactive.singleKey à true.

diff
Cela vous permet de revoir ce qui sera validé (c'est-à-dire entre HEAD et index).

ÉDITION PATCHS

L'appel de git add -e ou la sélection de e dans le sélecteur de morceau interactif ouvrira un patch dans
votre éditeur ; après la sortie de l'éditeur, le résultat est appliqué à l'index. Vous êtes libre de
apporter des modifications arbitraires au correctif, mais notez que certaines modifications peuvent être déroutantes
résultats, voire un patch qui ne peut pas être appliqué. Si vous souhaitez annuler le
opération entièrement (c'est-à-dire, rien de nouveau dans l'index), supprimez simplement toutes les lignes du
pièce. La liste ci-dessous décrit certaines choses courantes que vous pouvez voir dans un correctif, et qui
les opérations d'édition ont un sens sur eux.

contenu ajouté
Le contenu ajouté est représenté par des lignes commençant par "+". Vous pouvez empêcher la mise en scène de
ajouter des lignes en les supprimant.

contenu supprimé
Le contenu supprimé est représenté par des lignes commençant par "-". Vous pouvez empêcher la mise en scène
leur suppression en convertissant le "-" en un " " (espace).

contenu modifié
Le contenu modifié est représenté par des lignes "-" (suppression de l'ancien contenu) suivies de
lignes "+" (ajout du contenu de remplacement). Vous pouvez empêcher la mise en scène de la modification
en convertissant les lignes "-" en " " et en supprimant les lignes "+". Attention, modifier uniquement
la moitié de la paire est susceptible d'introduire des changements déroutants dans l'indice.

Il existe également des opérations plus complexes qui peuvent être effectuées. Mais attention car le
patch est appliqué uniquement à l'index et non à l'arbre de travail, l'arbre de travail apparaîtra
pour "annuler" la modification de l'index. Par exemple, introduire une nouvelle ligne dans l'index qui
n'est ni dans le HEAD ni dans l'arbre de travail ne mettra en scène la nouvelle ligne pour le commit, mais le
La ligne apparaîtra comme inversée dans l'arbre de travail.

Évitez d'utiliser ces constructions ou faites-le avec une extrême prudence.

suppression du contenu intact
Le contenu qui ne diffère pas entre l'index et l'arbre de travail peut être affiché sur
lignes de contexte, commençant par un " " (espace). Vous pouvez mettre en scène des lignes de contexte pour la suppression
en convertissant l'espace en "-". Le fichier d'arbre de travail résultant apparaîtra pour
rajouter le contenu.

modifier le contenu existant
On peut aussi modifier les lignes de contexte en les mettant en scène pour la suppression (en convertissant " " en
"-") et en ajoutant une ligne "+" avec le nouveau contenu. De même, on peut modifier les lignes "+"
pour les ajouts ou modifications existants. Dans tous les cas, la nouvelle modification sera
apparaissent inversés dans l'arbre de travail.

Nouveau contenu
Vous pouvez également ajouter du nouveau contenu qui n'existe pas dans le patch ; ajoutez simplement de nouvelles lignes,
chacun commençant par "+". L'ajout apparaîtra inversé dans l'arbre de travail.

Il y a aussi plusieurs opérations qu'il faut absolument éviter, car elles rendront le
patch impossible à appliquer :

· ajout de lignes de contexte (" ") ou de suppression ("-")

· suppression de contexte ou lignes de suppression

· modifier le contenu des lignes de contexte ou de suppression

Utilisez git-add en ligne en utilisant les services onworks.net