git-add — Online w chmurze

PROGRAM:

IMIĘ

git-add — Dodaj zawartość pliku do indeksu

STRESZCZENIE

odrzutowiec Dodaj [--pełne | -v] [--praca próbna | -n] [--force | -f] [--interaktywny | -i] [--łatka | -P]
[--edytuj | -e] [--[nie-]wszystko | --[no-]ignore-usuwanie | [--aktualizacja | -u]]
[--zamiar dodania | -N] [--refresh] [--ignore-errors] [--ignore-missing]
[--] [ ...]

OPIS

To polecenie aktualizuje indeks przy użyciu bieżącej zawartości znalezionej w drzewie roboczym
przygotuj zawartość wystawioną do następnego zatwierdzenia. Zwykle dodaje bieżącą zawartość
istniejące ścieżki jako całość, ale z niektórymi opcjami można ich również użyć do dodania treści
zastosuj tylko część zmian dokonanych w plikach drzewa roboczego lub usuń ścieżki, które to robią
nie istnieją już w drzewie roboczym.

„Indeks” przechowuje migawkę zawartości działającego drzewa i jest to ta migawka
jest to traktowane jako zawartość następnego zatwierdzenia. Zatem po wprowadzeniu jakichkolwiek zmian w pliku
roboczego i przed uruchomieniem polecenia zatwierdzenia należy użyć polecenia add, aby dodać
wszelkie nowe lub zmodyfikowane pliki do indeksu.

To polecenie można wykonać wiele razy przed zatwierdzeniem. Dodaje tylko treść
określone pliki w momencie uruchomienia polecenia add; jeśli chcesz późniejszych zmian
zawarte w następnym zatwierdzeniu, musisz ponownie uruchomić git add, aby dodać nową zawartość do
index.

Komendy git status można użyć do uzyskania podsumowania plików, w których występują zmiany
są przygotowywane do następnego zatwierdzenia.

Polecenie git add domyślnie nie doda ignorowanych plików. Jeśli jakiekolwiek ignorowane pliki były
wyraźnie określone w wierszu poleceń, git add zakończy się niepowodzeniem z listą ignorowanych plików.
Ignorowane pliki, do których osiągnięto rekursję katalogów lub manipulację nazwami plików wykonaną przez Git (quote
twoje kule przed powłoką) zostaną po cichu zignorowane. The odrzutowiec Dodaj można użyć polecenia
dodaj ignorowane pliki za pomocą opcji -f (wymuś).

Proszę zobaczyć git-commit(1) dla alternatywnych sposobów dodawania treści do zatwierdzenia.

OPCJE

...
Pliki, z których można dodać zawartość. Można podać kulki plików (np. *.c), aby dodać wszystkie pasujące elementy
akta. Może to być również wiodąca nazwa katalogu (np. dir, aby dodać katalog/plik1 i katalog/plik2).
podane do aktualizacji indeksu, aby pasował do bieżącego stanu katalogu jako całości (np
określenie katalogu spowoduje zarejestrowanie w drzewie roboczym nie tylko zmodyfikowanego pliku katalog/plik1, a
plik dir/file2 dodany do drzewa roboczego, ale także plik dir/file3 usunięty z
drzewo robocze. Zauważ, że starsze wersje Gita ignorowały usunięte pliki; używać
--no-all opcja, jeśli chcesz dodać zmodyfikowane lub nowe pliki, ale zignorować usunięte.

-n, --przebieg próbny
Właściwie nie dodawaj plików, po prostu pokaż, czy istnieją i/lub zostaną zignorowane.

-v, --pełne
Bądź gadatliwy.

-f, --siła
Zezwalaj na dodawanie w przeciwnym razie ignorowanych plików.

-i, --interaktywny
Dodaj zmodyfikowaną zawartość drzewa roboczego interaktywnie do indeksu. Ścieżka opcjonalna
Można podać argumenty, aby ograniczyć operację do podzbioru drzewa roboczego. Widzieć
„Tryb interaktywny”, aby uzyskać szczegółowe informacje.

-p, --poprawka
Interaktywnie wybierz fragmenty łatki pomiędzy indeksem a drzewem roboczym i dodaj je
do indeksu. Daje to użytkownikowi szansę sprawdzenia różnicy przed dodaniem
zmodyfikowana zawartość indeksu.

To skutecznie uruchamia add --interactive, ale omija początkowe menu poleceń i
bezpośrednio przechodzi do podkomendy patch. Aby uzyskać szczegółowe informacje, zobacz „Tryb interaktywny”.

-e, --edit
Otwórz różnicę względem indeksu w edytorze i pozwól użytkownikowi go edytować. Po redaktorze
został zamknięty, dostosuj nagłówki porcji i zastosuj łatkę do pliku Index.

Celem tej opcji jest wybranie linii łatki do zastosowania lub nawet
aby zmodyfikować zawartość wierszy, które mają być wystawiane. Może to być szybsze i bardziej elastyczne
niż używanie interaktywnego selektora porcji. Jednak łatwo jest się pomylić i
utwórz łatkę, która nie ma zastosowania do indeksu. Zobacz EDYCJA POPRAWEK poniżej.

-u, --aktualizacja
Zaktualizuj indeks tam, gdzie już zawiera pasujący wpis . To usuwa
a także modyfikuje wpisy indeksu, aby pasowały do ​​​​działającego drzewa, ale nie dodaje żadnych nowych plików.

Jeśli nie jest podawane, gdy użyta jest opcja -u, wszystkie śledzone pliki w całości
drzewo robocze jest aktualizowane (stare wersje Git używane były do ​​ograniczania aktualizacji do bieżącego
katalog i jego podkatalogi).

-A, --all, --no-ignore-usuwanie
Aktualizuj indeks nie tylko tam, gdzie drzewo robocze ma pasujący plik Ale
również tam, gdzie indeks ma już wpis. To dodaje, modyfikuje i usuwa indeks
wpisy pasujące do drzewa roboczego.

Jeśli nie jest podawane, gdy użyta jest opcja -A, wszystkie pliki w całym drzewie roboczym
są aktualizowane (stare wersje Git ograniczały aktualizację do bieżącego katalogu i
jego podkatalogi).

--no-all, --ignore-usuwanie
Zaktualizuj indeks, dodając nowe, nieznane w indeksie pliki i pliki zmodyfikowane
w drzewie roboczym, ale zignoruj ​​pliki, które zostały usunięte z drzewa roboczego.
Ta opcja nie ma zastosowania, gdy nie Jest używane.

Ta opcja ma przede wszystkim pomóc użytkownikom przyzwyczajonym do starszych wersji Gita, których
„git dodaj …” był synonimem „git add --no-all ...", tj
zignorował usunięte pliki.

-N, --zamiar-dodania
Zapisz tylko fakt, że ścieżka zostanie dodana później. Wpis dotyczący ścieżki to
umieszczone w indeksie bez treści. Przydaje się to między innymi do pokazywania
niezatwierdzoną zawartość takich plików za pomocą git diff i zatwierdzanie ich za pomocą git commit
-I.

--odświeżać
Nie dodawaj plików, a jedynie odśwież ich informacje stat() w indeksie.

--ignoruj-błędy
Jeśli nie udało się dodać niektórych plików z powodu błędów podczas ich indeksowania, nie przerywaj
operację, ale kontynuuj dodawanie pozostałych. Polecenie nadal będzie kończyć się z wartością niezerową
status. W tym celu zmienną konfiguracyjną add.ignoreErrors można ustawić na wartość true
zachowanie domyślne.

--ignoruj-brakujące
Opcji tej można używać tylko razem z opcją --dry-run. Korzystając z tej opcji użytkownik
może sprawdzić, czy któryś z podanych plików zostanie zignorowany, niezależnie od tego, czy już jest
obecny w drzewie roboczym, czy nie.

--
Opcji tej można użyć do oddzielenia opcji wiersza poleceń od listy plików,
(przydatne, gdy nazwy plików mogą zostać pomylone z opcjami wiersza poleceń).

KONFIGURACJA

Opcjonalna zmienna konfiguracyjna core.excludesFile wskazuje ścieżkę do pliku
zawierający wzorce nazw plików do wykluczenia z git-add, podobne do
$GIT_DIR/info/exclude. Wzorce z pliku wykluczeń są używane dodatkowo do wzorców znajdujących się w
informacje/wykluczenie. Widzieć gitignore(5).

PRZYKŁADY

· Dodaje zawartość ze wszystkich plików *.txt do katalogu Dokumentacja i jego
podkatalogi:

$ git dodaj Dokumentację/\*.txt

Zwróć uwagę, że w tym przykładzie gwiazdka * jest cytowana z powłoki; to pozwala
polecenie uwzględnia pliki z podkatalogów katalogu Dokumentacja/.

· Rozważa dodanie treści ze wszystkich skryptów git-*.sh:

$ git dodaj git-*.sh

Ponieważ ten przykład pozwala powłoce rozwinąć gwiazdkę (tzn. wyświetlasz listę
pliki jawnie), nie uwzględnia podkatalogu/git-foo.sh.

INTERAKTYWNY TRYB

Gdy polecenie przejdzie w tryb interaktywny, wyświetli wynik działania status
podpolecenie, a następnie przechodzi do interaktywnej pętli poleceń.

Pętla poleceń wyświetla listę dostępnych podpoleceń i wyświetla pytanie „Co teraz>”.
Ogólnie rzecz biorąc, gdy znak zachęty kończy się pojedynczym >, możesz wybrać tylko jedną z opcji
podane i wpisz return, w ten sposób:

*** Polecenia ***
1: status 2: aktualizacja 3: przywróć 4: dodaj nieśledzone
5: poprawka 6: różnica 7: wyjście 8: pomoc
Co teraz> 1

Możesz także powiedzieć s, sta lub status powyżej, o ile wybór jest unikalny.

Główna pętla poleceń ma 6 podpoleceń (plus pomoc i wyjście).

status
To pokazuje zmianę pomiędzy HEAD a indeksem (tzn. co zostanie zatwierdzone, jeśli powiesz
git commit) oraz pomiędzy plikami indeksu i drzewa roboczego (tj. tym, co możesz przygotować
dalej przed zatwierdzeniem git za pomocą git add) dla każdej ścieżki. Przykładowe wyjście wygląda
to:

etapowana ścieżka niescenizowana
1: nic binarnego foo.png
2: +403/-35 +1/-1 git-add--interactive.perl

Pokazuje, że foo.png różni się od HEAD (ale jest to plik binarny, więc liczba linii
nie można wyświetlić) i nie ma różnicy między kopią indeksowaną a drzewem roboczym
wersja (jeśli wersja drzewa roboczego również była inna, dwójkowy zostałoby pokazane
zamiast nic). Drugi plik, git-add--interactive.perl, zawiera 403 dodane linie
i 35 linii usuniętych, jeśli zatwierdzisz to, co jest w indeksie, ale plik drzewa roboczego tak
dalsze modyfikacje (jedno dodanie i jedno skreślenie).

aktualizacja
Spowoduje to wyświetlenie informacji o statusie i wyświetlenie monitu „Aktualizacja >>”. Kiedy pojawi się monit
kończy się na dwójce >>, możesz dokonać więcej niż jednego wyboru połączonego z
spacja lub przecinek. Można też powiedzieć zakresy. Np. „2-5 7,9”, aby wybrać 2,3,4,5,7,9
z listy. Jeśli druga liczba w zakresie zostanie pominięta, wszystkie pozostałe poprawki zostaną pominięte
zajęty. Np. „7-”, aby wybrać 7,8,9 z listy. Możesz powiedzieć * wybrać wszystko.

To, co wybrałeś, zostanie następnie wyróżnione *, Jak poniżej:

etapowana ścieżka niescenizowana
1: nic binarnego foo.png
* 2: +403/-35 +1/-1 git-add--interactive.perl

Aby usunąć zaznaczenie, poprzedź wejście - w ten sposób:

Aktualizacja >> -2

Po dokonaniu wyboru odpowiedz pustą linią, aby określić zawartość pracy
pliki drzewa dla wybranych ścieżek w indeksie.

przywrócić
Ma bardzo podobny interfejs użytkownika do aktualizacjaoraz informacje etapowe dla wybranych ścieżek
zostaną przywrócone do wersji HEAD. Cofanie nowych ścieżek powoduje, że stają się one nieśledzone.

dodaj nieśledzone
Ma bardzo podobny interfejs użytkownika do aktualizacja i przywrócići pozwala dodawać nieśledzone ścieżki do
indeks.

łata
Dzięki temu możesz wybrać jedną ścieżkę z status jak selekcja. Po wybraniu ścieżki
przedstawia różnicę między indeksem a działającym plikiem drzewa i pyta, czy tak
chcą zainscenizować zmianę każdego przystojniaka. Możesz wybrać jedną z następujących opcji i
wpisz zwrot:

y - wystawić tego przystojniaka
n - nie wystawiaj tego przystojniaka
q - wyjdź; nie wystawiaj tego przystojniaka ani żadnego z pozostałych
a - przygotuj tę porcję i wszystkie późniejsze porcje w pliku
d - nie wystawiaj tej porcji ani żadnych późniejszych porcji w pliku
g - wybierz porcję, do której chcesz się udać
/ - wyszukaj porcję pasującą do podanego wyrażenia regularnego
j - zostaw tę porcję niezdecydowaną, zobacz następną niezdecydowaną porcję
J - zostaw tę porcję niezdecydowaną, zobacz następną porcję
k - pozostaw tę porcję niezdecydowaną, zobacz poprzednią niezdecydowaną porcję
K - zostaw tę porcję niezdecydowaną, zobacz poprzednią porcję
s - podziel bieżącą porcję na mniejsze porcje
e - ręcznie edytuj bieżącą porcję
? - wydrukuj pomoc

Po podjęciu decyzji o losie wszystkich porcji, jeśli została wybrana jakakolwiek porcja, indeks
jest aktualizowany o wybrane porcje.

Można pominąć wpisywanie tutaj return, ustawiając zmienną konfiguracyjną
interaktywny.singleKey na true.

diff
Dzięki temu możesz sprawdzić, co zostanie zatwierdzone (tj. pomiędzy HEAD a indeksem).

REDAGOWANIE ŁATKI

Wywołanie git add -e lub wybranie e z interaktywnego selektora porcji spowoduje otwarcie łatki
twój redaktor; po wyjściu edytora wynik zostaje zastosowany do indeksu. Możesz to zrobić bezpłatnie
wprowadzaj dowolne zmiany w łatce, ale pamiętaj, że niektóre zmiany mogą być mylące
wyniki, a nawet spowodować, że łatka nie będzie mogła zostać zastosowana. Jeśli chcesz przerwać
całkowicie (tzn. nie wprowadzaj niczego nowego do indeksu), po prostu usuń wszystkie linie pliku
skrawek. Poniższa lista opisuje niektóre typowe rzeczy, które możesz zobaczyć w łatce, i które
operacje edycyjne mają na nich sens.

dodana treść
Dodana treść jest reprezentowana przez linie rozpoczynające się od „+”. Możesz zapobiec inscenizacji
dodawanie linii poprzez ich usuwanie.

usunięta treść
Usunięta treść jest reprezentowana przez linie rozpoczynające się od „-”. Możesz zapobiec inscenizacji
ich usunięcie poprzez konwersję „-” na „” (spację).

zmodyfikowana treść
Zmodyfikowana treść jest reprezentowana przez linie „-” (usuwanie starej treści), po których następuje znak „-”.
Linie „+” (dodawanie treści zastępczej). Można zapobiec przemieszczaniu modyfikacji
konwertując linie „-” na „” i usuwając linie „+”. Uważaj, to tylko modyfikowanie
połowa pary prawdopodobnie wprowadzi mylące zmiany w indeksie.

Można także wykonać bardziej złożone operacje. Ale uważaj, ponieważ
patch zostanie zastosowany tylko do indeksu, a nie do drzewa roboczego, pojawi się drzewo robocze
aby „cofnąć” zmianę w indeksie. Na przykład wprowadzenie nowej linii do indeksu that
nie znajduje się ani w HEAD, ani w drzewie roboczym, nie wyświetli nowej linii do zatwierdzenia, ale plik
linia w drzewie roboczym będzie wyglądać na przywróconą.

Unikaj używania tych konstrukcji lub rób to z najwyższą ostrożnością.

usuwanie nietkniętej zawartości
Można na nim wyświetlać treści nie różniące się od indeksu do drzewa roboczego
linie kontekstu, rozpoczynające się od „ ” (spacji). Możesz przygotować linie kontekstu do usunięcia
zamieniając spację na „-”. Pojawi się powstały plik drzewa roboczego
ponownie dodaj treść.

modyfikowanie istniejących treści
Można także modyfikować linie kontekstu, przygotowując je do usunięcia (konwertując „ ” na
„-”) i dodanie linii „+” z nową treścią. Podobnie można modyfikować linie „+”.
w przypadku istniejących uzupełnień lub modyfikacji. We wszystkich przypadkach nowa modyfikacja tak będzie
pojawiają się w drzewie roboczym jako przywrócone.

nowa zawartość
Możesz także dodać nową zawartość, która nie istnieje w łatce; po prostu dodaj nowe linie,
każdy zaczynający się od „+”. Dodatek pojawi się jako przywrócony w drzewie roboczym.

Istnieje również kilka operacji, których należy całkowicie unikać, ponieważ powodują one uszkodzenie
łatka niemożliwa do nałożenia:

· dodanie kontekstu („ „) lub usunięcie („-”) wierszy

· usuwanie kontekstu lub linii usuwania

· modyfikowanie zawartości kontekstu lub usuwanie linii

Użyj git-add online, korzystając z usług onworks.net