git-add - Online in de cloud

PROGRAMMA:

NAAM

git-add - Voeg bestandsinhoud toe aan de index

KORTE INHOUD

git toevoegen [--uitgebreide | -v] [--droogloop | -n] [--kracht | -f] [--interactieve | -i] [--patch | -P]
[--bewerk | -e] [--[geen-]alles | --[no-]negeer-verwijdering | [--bijwerken | -u]]
[--intentie om toe te voegen | -N] [--vernieuwen] [--negeer-fouten] [--negeer-ontbreekt]
[--] [ ...]

PRODUCTBESCHRIJVING

Deze opdracht werkt de index bij met behulp van de huidige inhoud die in de werkboom is gevonden, naar
bereid de inhoud voor de volgende commit voor. Het voegt meestal de huidige inhoud van toe
bestaande paden als geheel, maar met sommige opties kan het ook worden gebruikt om inhoud aan toe te voegen
slechts een deel van de wijzigingen die in de werkende boombestanden zijn aangebracht, worden toegepast, of verwijder paden die dat wel doen
bestaat niet meer in de werkende boom.

De "index" bevat een momentopname van de inhoud van de werkboom, en het is deze momentopname
dat wordt genomen als de inhoud van de volgende commit. Dus na het aanbrengen van wijzigingen in de
werkende boom, en voordat je het commit commando uitvoert, moet je het add commando gebruiken om toe te voegen
eventuele nieuwe of gewijzigde bestanden in de index.

Dit commando kan meerdere keren worden uitgevoerd vóór een commit. Het voegt alleen de inhoud toe van
het (de) opgegeven bestand(en) op het moment dat het add-commando wordt uitgevoerd; als u latere wijzigingen wilt
opgenomen in de volgende commit, dan moet je git add opnieuw uitvoeren om de nieuwe inhoud aan de
index.

Het git status commando kan gebruikt worden om een ​​samenvatting te verkrijgen van welke bestanden wijzigingen hebben
worden geënsceneerd voor de volgende commit.

Het git add commando zal standaard geen genegeerde bestanden toevoegen. Als er genegeerde bestanden zijn
expliciet gespecificeerd op de commandoregel, zal git add mislukken met een lijst met genegeerde bestanden.
Genegeerde bestanden bereikt door directoryrecursie of bestandsnaamglobbing uitgevoerd door Git (quote
je globs voor de shell) wordt stilzwijgend genegeerd. De git toevoegen commando kan worden gebruikt
voeg genegeerde bestanden toe met de optie -f (forceren).

Alsjeblieft zie git-commit(1) voor alternatieve manieren om inhoud aan een commit toe te voegen.

OPTIES

...
Bestanden waaruit inhoud kan worden toegevoegd. Fileglobs (bijv. *.c) kunnen worden gegeven om alle overeenkomsten toe te voegen
bestanden. Ook een leidende mapnaam (bijvoorbeeld map om map/bestand1 en map/bestand2 toe te voegen) kan dat zijn
gegeven om de index bij te werken zodat deze overeenkomt met de huidige status van de map als geheel (bijv
het specificeren van dir zal niet alleen een bestand dir/file1 opnemen dat gewijzigd is in de werkboom, a
bestand dir/file2 toegevoegd aan de werkboom, maar ook een bestand dir/file3 verwijderd uit de
werkende boom. Merk op dat oudere versies van Git verwijderde bestanden negeerden; gebruik
--no-all optie als u gewijzigde of nieuwe bestanden wilt toevoegen, maar de verwijderde bestanden wilt negeren.

-n, --drooglopen
Voeg de bestanden niet daadwerkelijk toe, maar laat alleen zien of ze bestaan ​​en/of genegeerd zullen worden.

-v, --uitgebreid
Wees breedsprakig.

-f, --kracht
Toestaan ​​dat anders genegeerde bestanden worden toegevoegd.

-i, --interactief
Voeg gewijzigde inhoud in de werkboom interactief toe aan de index. Optioneel pad
Er kunnen argumenten worden opgegeven om de werking te beperken tot een subset van de werkboom. Zien
“Interactieve modus” voor details.

-p, --patch
Kies interactief stukjes patch tussen de index en de werkboom en voeg deze toe
naar de index. Dit geeft de gebruiker de kans om het verschil te bekijken alvorens toe te voegen
gewijzigde inhoud van de index.

Hierdoor wordt effectief add --interactive uitgevoerd, maar wordt het initiële opdrachtmenu en
springt direct naar het patch-subcommando. Zie “Interactieve modus” voor details.

-e, --edit
Open de diff versus de index in een editor en laat de gebruiker deze bewerken. Na de redacteur
was gesloten, past u de hunk-headers aan en past u de patch toe op de index.

De bedoeling van deze optie is om lijnen van de patch te kiezen en te kiezen die u wilt toepassen, of zelfs
om de inhoud van regels die moeten worden geënsceneerd te wijzigen. Dit kan sneller en flexibeler
dan het gebruik van de interactieve hunk-selector. Het is echter gemakkelijk om jezelf en te verwarren
maak een patch die niet van toepassing is op de index. Zie PATCHES BEWERKEN hieronder.

-u, --bijwerken
Werk de index bij waar deze al een overeenkomende vermelding bevat . Dit verwijdert
en wijzigt ook indexitems zodat deze overeenkomen met de werkboom, maar voegt geen nieuwe bestanden toe.

Als Nee wordt gegeven wanneer de optie -u wordt gebruikt, alle bijgehouden bestanden in het geheel
werkboom zijn bijgewerkt (oude versies van Git die werden gebruikt om de update te beperken tot de huidige
directory en zijn subdirectories).

-A, --all, --no-negeer-verwijdering
Werk de index niet alleen bij waar de werkende boom een ​​overeenkomend bestand heeft Maar
ook als de index al een vermelding heeft. Hiermee wordt index toegevoegd, gewijzigd en verwijderd
vermeldingen die overeenkomen met de werkboom.

Als Nee wordt gegeven wanneer -A optie wordt gebruikt, alle bestanden in de gehele werkende boom
zijn bijgewerkt (oude versies van Git gebruikten om de update te beperken tot de huidige map en
zijn submappen).

--no-all, --negeer-verwijdering
Werk de index bij door nieuwe bestanden toe te voegen die onbekend zijn in de index en door gewijzigde bestanden
in de werkboom, maar negeer bestanden die uit de werkboom zijn verwijderd.
Deze optie is een no-op wanneer nee is gebruikt.

Deze optie is voornamelijk bedoeld om gebruikers te helpen die gewend zijn aan oudere versies van Git, waarvan
"git voeg toe ..." was een synoniem voor "git add --no-all ...", dwz
negeerde verwijderde bestanden.

-N, --intentie om toe te voegen
Noteer alleen het feit dat het pad later wordt toegevoegd. Een invoer voor het pad is
zonder inhoud in de index geplaatst. Dit is onder andere handig voor het tonen
de niet-gefaseerde inhoud van dergelijke bestanden met git diff en deze vastleggen met git commit
-a.

--vernieuwen
Voeg de bestanden niet toe, maar vernieuw alleen hun stat()-informatie in de index.

--negeer-fouten
Als sommige bestanden niet konden worden toegevoegd vanwege fouten bij het indexeren ervan, mag u het
bewerking, maar ga door met het toevoegen van de andere. De opdracht wordt nog steeds afgesloten met niet-nul
toestand. Hiervoor kan de configuratievariabele add.ignoreErrors op true worden ingesteld
het standaardgedrag.

--negeren-ontbrekend
Deze optie kan alleen samen met --dry-run worden gebruikt. Door deze optie te gebruiken, kan de gebruiker
kan controleren of een van de opgegeven bestanden wordt genegeerd, ongeacht of dit al het geval is
aanwezig in de werkboom of niet.

--
Deze optie kan worden gebruikt om opdrachtregelopties te scheiden van de lijst met bestanden,
(handig als bestandsnamen kunnen worden aangezien voor opdrachtregelopties).

CONFIGURATIE

De optionele configuratievariabele core.excludesFile geeft een pad naar een bestand aan
met patronen van bestandsnamen die moeten worden uitgesloten van git-add, vergelijkbaar met
$GIT_DIR/info/exclude. Patronen in het uitsluitingsbestand worden gebruikt als aanvulling op die in
info/uitsluiten. Zien negeren(5).

Voorbeelden

· Voegt inhoud toe van alle *.txt-bestanden onder de map Documentatie en de bijbehorende map
submappen:

$ git add Documentatie/\*.txt

Merk op dat in dit voorbeeld het sterretje * uit de shell wordt geciteerd; dit laat de
commando omvat de bestanden uit submappen van Documentatie/map.

· Overweegt het toevoegen van inhoud van alle git-*.sh-scripts:

$ git voeg git-*.sh toe

Omdat dit voorbeeld de shell de asterisk laat uitvouwen (dwz u vermeldt de
bestanden expliciet), houdt het geen rekening met subdir/git-foo.sh.

INTERACTIEF MODE

Wanneer het commando de interactieve modus binnengaat, toont het de uitvoer van het toestand
subopdracht en gaat vervolgens naar de interactieve opdrachtlus.

De opdrachtlus toont de lijst met beschikbare subopdrachten en geeft een prompt "Wat nu>".
Over het algemeen eindigt de prompt met een single >, kunt u slechts één van de keuzes kiezen
gegeven en typ return, zoals dit:

*** Commando's ***
1: status 2: update 3: terugzetten 4: niet gevolgd toevoegen
5: patch 6: diff 7: stoppen 8: help
Wat nu> 1

Je kunt hierboven ook s of sta of status zeggen, zolang de keuze maar uniek is.

De hoofdopdrachtlus heeft 6 subopdrachten (plus help en quit).

toestand
Dit toont de verandering tussen HEAD en index (dat wil zeggen wat er wordt vastgelegd als je zegt
git commit), en tussen index- en werkboombestanden (dwz wat je zou kunnen stagen
verder voordat git commit met behulp van git add) voor elk pad. Een voorbeelduitvoer ziet er zo uit
deze:

geënsceneerd, niet-geënsceneerd pad
1: binair niets foo.png
2: +403/-35 +1/-1 git-add--interactive.perl

Het laat zien dat foo.png verschillen heeft met HEAD (maar dat is binair, dus het aantal regels
kan niet worden weergegeven) en er is geen verschil tussen de geïndexeerde kopie en de werkboom
versie (als de werkende boomversie ook anders was, binair zou zijn getoond
in plaats van niets). Het andere bestand, git-add--interactive.perl, heeft 403 regels toegevoegd
en 35 regels verwijderd als je vastlegt wat er in de index staat, maar het werkende boombestand wel
verdere wijzigingen (één toevoeging en één verwijdering).

-update
Dit toont de statusinformatie en geeft een "Update>>" prompt. Wanneer de prompt
eindigt op dubbel >>, kunt u meer dan één selectie maken, samengevoegd met
spatie of komma. Je kunt ook bereiken zeggen. Bijv. "2-5 7,9" om 2,3,4,5,7,9 te kiezen
van de lijst. Als het tweede getal in een bereik wordt weggelaten, zijn alle resterende patches dat ook
genomen. Bijv. "7-" om 7,8,9 uit de lijst te kiezen. Je kunt zeggen * alles te kiezen.

Wat u heeft gekozen, wordt vervolgens gemarkeerd met *, In deze trant:

geënsceneerd, niet-geënsceneerd pad
1: binair niets foo.png
* 2: +403/-35 +1/-1 git-add--interactive.perl

Om de selectie te verwijderen, laat u de invoer voorafgaan door - zoals dit:

Bijwerken >> -2

Nadat u de selectie hebt gemaakt, antwoordt u met een lege regel om de inhoud van het werk in scène te zetten
boombestanden voor geselecteerde paden in de index.

terugkeren
Dit heeft een zeer vergelijkbare gebruikersinterface als -updateen de geënsceneerde informatie voor geselecteerde paden
worden teruggezet naar die van de HEAD-versie. Het omkeren van nieuwe paden zorgt ervoor dat ze niet meer gevolgd worden.

voeg niet gevolgd toe
Dit heeft een zeer vergelijkbare gebruikersinterface als -update en terugkeren, en laat je niet-gevolgde paden toevoegen aan
de index.

stuk
Hiermee kunt u één pad kiezen uit een toestand zoals selectie. Nadat u het pad heeft gekozen,
het presenteert het verschil tussen de index en het werkboombestand en vraagt ​​u of u
wil de verandering van elke bink in scène zetten. U kunt een van de volgende opties selecteren en
typ retour:

y - ensceneer dit stuk
n - ensceneer dit stuk niet
q - stoppen; ensceneer dit stuk of een van de overige niet
a - plaats deze hunk en alle latere hunks in het bestand
d - stage deze hunk of een van de latere hunks in het bestand niet
g - selecteer een hunk waar u naartoe wilt gaan
/ - zoek naar een hunk die overeenkomt met de gegeven regex
j - laat dit stuk onbeslist, zie het volgende onbesliste stuk
J - laat deze hunk onbeslist, zie de volgende hunk
k - laat dit hunk onbeslist, zie vorige onbesliste hunk
K - laat deze hunk onbeslist, zie vorige hunk
s - splits het huidige deel in kleinere delen
e - bewerk de huidige hunk handmatig
? - afdrukhulp

Nadat het lot voor alle hunks is bepaald, wordt, als er een hunk is gekozen, de index
wordt bijgewerkt met de geselecteerde hunks.

U kunt het typen van return hier achterwege laten door de configuratievariabele in te stellen
interactief.singleKey naar waar.

diff
Hiermee kunt u bekijken wat er wordt vastgelegd (dwz tussen HEAD en index).

BEWERKEN PATCHES

Het aanroepen van git add -e of het selecteren van e uit de interactieve hunk-selector zal een patch openen
uw redacteur; nadat de editor is afgesloten, wordt het resultaat toegepast op de index. U bent vrij om
willekeurige wijzigingen in de patch aanbrengen, maar houd er rekening mee dat sommige wijzigingen verwarrend kunnen zijn
resultaten, of zelfs resulteren in een patch die niet kan worden toegepast. Als u de
bewerking volledig (dat wil zeggen, plaats niets nieuws in de index), verwijder eenvoudigweg alle regels van de
lapje. De onderstaande lijst beschrijft enkele veelvoorkomende dingen die u in een patch kunt tegenkomen, en welke
bewerkingsbewerkingen zijn zinvol voor hen.

toegevoegde inhoud
Toegevoegde inhoud wordt weergegeven door regels die beginnen met "+". U kunt stagnatie voorkomen
regels toevoegen door ze te verwijderen.

verwijderde inhoud
Verwijderde inhoud wordt weergegeven door regels die beginnen met "-". Je kunt enscenering voorkomen
hun verwijdering door de "-" om te zetten in een " " (spatie).

gewijzigde inhoud
Gewijzigde inhoud wordt weergegeven door "-" regels (waarbij de oude inhoud wordt verwijderd), gevolgd door
"+" regels (waarbij de vervangende inhoud wordt toegevoegd). U kunt voorkomen dat de wijziging wordt doorgevoerd
door "-" regels om te zetten in " ", en "+" regels te verwijderen. Pas op dat alleen wijzigen
de helft van het paar zal waarschijnlijk verwarrende wijzigingen in de index doorvoeren.

Er zijn ook complexere operaties die kunnen worden uitgevoerd. Maar pas op, want de
patch alleen op de index wordt toegepast en niet op de werkboom, zal de werkboom verschijnen
om de wijziging in de index "ongedaan te maken". Bijvoorbeeld door een nieuwe regel in de index te introduceren die
noch in de HEAD, noch in de werkboom staat, zal de nieuwe regel voor commit in scène zetten, maar de
Het lijkt alsof de lijn in de werkende boom is teruggedraaid.

Vermijd het gebruik van deze constructies, of doe dit met uiterste voorzichtigheid.

onaangeroerde inhoud verwijderen
Er kan inhoud worden weergegeven die niet verschilt tussen de index en de werkboom
contextregels, beginnend met een " " (spatie). U kunt contextregels klaarzetten voor verwijdering
door de spatie om te zetten in een "-". Het resulterende werkboombestand zal verschijnen
voeg de inhoud opnieuw toe.

bestaande inhoud aanpassen
Men kan ook contextregels wijzigen door ze klaar te zetten voor verwijdering (door " " te converteren naar
"-") en een "+" regel toevoegen met de nieuwe inhoud. Op dezelfde manier kan men "+"-regels wijzigen
voor bestaande toevoegingen of wijzigingen. In alle gevallen zal de nieuwe wijziging
lijken omgekeerd in de werkende boom.

nieuwe inhoud
Je kunt ook nieuwe inhoud toevoegen die niet in de patch bestaat; voeg eenvoudig nieuwe regels toe,
elk beginnend met "+". De toevoeging zal in de werkboom teruggedraaid verschijnen.

Er zijn ook verschillende operaties die volledig moeten worden vermeden, omdat ze de
patch onmogelijk aan te brengen:

· context toevoegen (" ") of verwijderen ("-") regels

· het verwijderen van context of verwijderingsregels

· de inhoud van context- of verwijderingsregels wijzigen

Gebruik git-add online met behulp van onworks.net-services