git-notes - Online in de cloud

PROGRAMMA:

NAAM

git-notes - Objectnotities toevoegen of inspecteren

KORTE INHOUD

git aantekeningen [lijst [ ]]
git aantekeningen toevoegen [-f] [--allow-leeg] [-F | -M | (-c | -C) ] [ ]
git aantekeningen kopieer [-f] ( --stdin | )
git aantekeningen voeg toe [--allow-leeg] [-F | -M | (-c | -C) ] [ ]
git aantekeningen bewerk [--allow-leeg] [ ]
git aantekeningen show [ ]
git aantekeningen samenvoegen [-v | -q] [-s ]
git aantekeningen merge --commit [-v | -Q]
git aantekeningen samenvoegen --afbreken [-v | -Q]
git aantekeningen verwijder [--negeer-ontbreekt] [--stdin] [ ...]
git aantekeningen snoeien [-n | -v]
git aantekeningen krijg-ref

PRODUCTBESCHRIJVING

Voegt toe, verwijdert of leest notities die aan objecten zijn gekoppeld, zonder de objecten aan te raken
zich.

Standaard worden notities opgeslagen in en gelezen uit refs/notes/commits, maar deze standaard kan dat zijn
overschreven. Zie de secties OPTIES, CONFIGURATIE en OMGEVING hieronder. Als dit ref
niet bestaat, wordt het stilletjes aangemaakt wanneer het voor het eerst nodig is om een ​​notitie op te slaan.

Een typisch gebruik van notities is om een ​​commit-bericht aan te vullen zonder de commit te wijzigen
zelf. Notities kunnen worden getoond door git inloggen samen met het oorspronkelijke commit-bericht. Naar
om deze notities te onderscheiden van het bericht dat is opgeslagen in het commit-object, zijn de notities
ingesprongen zoals het bericht, na een niet-ingesprongen regel met "Notes ( ):" (of
"Notes:" voor refs/notes/commits).

Opmerkingen kunnen ook worden toegevoegd aan patches die zijn voorbereid met git format-patch door gebruik te maken van --notes
keuze. Dergelijke notities worden toegevoegd als patchcommentaar na een scheidingslijn met drie streepjes.

Om te wijzigen welke noten worden weergegeven door git inloggen, zie de configuratie "notes.displayRef" in
git-log(1).

Zie de "notes.rewrite. " configuratie voor een manier om notities over commando's te dragen
dat herschrijven commits.

SUBCOMMANDO'S

lijst
Maak een lijst van het Notes-object voor een bepaald object. Als er geen object is opgegeven, laat dan een lijst van alle zien
noteer objecten en de objecten waaraan ze annoteren (in het formaat "
object>"). Dit is het standaard subcommando als er geen subcommando is gegeven.

toevoegen
Voeg notities toe voor een bepaald object (standaard ingesteld op HEAD). Afbreken als het object al notities heeft
(gebruik -f om bestaande notities te overschrijven). Als u add echter interactief gebruikt
(met behulp van een editor om de inhoud van de notities aan te leveren), dan - in plaats van af te breken - de
bestaande notities worden geopend in de editor (zoals het subcommando bewerken).

kopiëren
Kopieer de notities voor het eerste object naar het tweede object. Afbreken als het tweede object
al notities heeft, of als het eerste object er geen heeft (gebruik -f om bestaande notities te overschrijven
naar het tweede object). Dit subcommando is gelijk aan: git notes add [-f] -C $(git
notities lijst )

Neem in --stdin-modus regels in het formaat

SP [SP ] LF

op standaardinvoer en kopieer de notities van elk naar de corresponderende
. (De optionele wordt genegeerd zodat de opdracht de invoer kan lezen
gegeven aan de post-rewrite hook.)

toevoegen
Voeg toe aan de notities van een bestaand object (standaard ingesteld op HEAD). Creëert een nieuwe notitie
indien nodig bezwaar maken.

Bewerken
Bewerk de notities voor een bepaald object (standaard ingesteld op HEAD).

tonen
Toon de notities voor een bepaald object (standaard ingesteld op HEAD).

samensmelten
Voeg de gegeven notenref samen met de huidige notenref. Dit zal proberen om de
wijzigingen aangebracht door de gegeven notities ref ("remote" genoemd) sinds de merge-base (indien aanwezig)
in de huidige noten ref ("local" genoemd).

Als er conflicten ontstaan ​​en een strategie voor het automatisch oplossen van tegenstrijdige notities (zie
de sectie "NOTES MERGE STRATEGIES") niet wordt gegeven, wordt de "handmatige" resolver gebruikt.
Deze resolver checkt de conflicterende notities uit in een speciale werkboom
(.git/NOTES_MERGE_WORKTREE), en instrueert de gebruiker om de conflicten handmatig op te lossen
daar. Wanneer dit is voltooid, kan de gebruiker de samenvoeging voltooien met git aantekeningen samensmelten
--verbinden, of annuleer het samenvoegen met git aantekeningen samensmelten --afbreken.

verwijderen
Verwijder de notities voor bepaalde objecten (standaard ingesteld op HEAD). Bij het geven van nul of één object
vanaf de opdrachtregel komt dit overeen met het specificeren van een leeg notitiebericht aan het
subcommando bewerken.

snoeien
Verwijder alle notities voor niet-bestaande/onbereikbare objecten.

krijg-ref
Print de huidige notities ref. Dit biedt een gemakkelijke manier om de huidige notities op te halen
ref (bijvoorbeeld uit scripts).

OPTIES

-f, --kracht
Als u notities toevoegt aan een object dat al notities heeft, overschrijf dan de bestaande notities
(in plaats van afbreken).

-M , --bericht=
Gebruik het gegeven notitiebericht (in plaats van te vragen). Als er meerdere -m opties worden gegeven,
hun waarden worden samengevoegd als afzonderlijke alinea's. Regels beginnend met # en leeg
andere regels dan een enkele regel tussen alinea's worden verwijderd.

-F , --bestand=
Neem het notitiebericht uit het gegeven bestand. Gebruik - om het notitiebericht van de te lezen
standaard invoer. Regels die beginnen met # en lege regels anders dan een enkele regel ertussen
alinea's worden eruit gehaald.

-C , --hergebruik-bericht=
Neem het gegeven blob-object (bijvoorbeeld een andere notitie) als het notitiebericht. (Gebruik git
notities kopiëren in plaats daarvan om notities tussen objecten te kopiëren.)

-C , --reedit-bericht=
Like -C, maar met -c de editor wordt aangeroepen, zodat de gebruiker de notitie verder kan bewerken
bericht.

--toestaan-leeg
Toestaan ​​dat een leeg notitie-object wordt opgeslagen. Het standaardgedrag is automatisch
lege notities verwijderen.

--ref
Manipuleer de notenboom in . Dit overschrijft GIT_NOTES_REF en
"core.notesRef"-configuratie. De ref specificeert de volledige refnaam wanneer deze begint met
referenties/notities/; wanneer het begint met notes/, wordt refs/ en anders wordt refs/notes/ voorafgegaan
om een ​​volledige naam van de ref te vormen.

--negeren-ontbrekend
Beschouw het niet als een fout om te vragen om notities te verwijderen van een object dat dat niet doet
heb er aantekeningen bij.

--standaard
Lees ook de objectnamen om notities uit de standaardinvoer te verwijderen (er is geen
reden dat u dit niet kunt combineren met objectnamen vanaf de opdrachtregel).

-n, --drooglopen
Verwijder niets; rapporteer gewoon de objectnamen waarvan de notities zouden worden verwijderd.

-s , --strategie=
Los bij het samenvoegen van notities notitieconflicten op met behulp van de gegeven strategie. Het volgende
strategieën worden herkend: "manual" (standaard), "ours", "theirs", "union" en
"cat_sort_uniq". Deze optie heft de configuratie "notes.mergeStrategy" op
instelling. Zie het gedeelte "NOTES MERGE STRATEGIES" hieronder voor meer informatie over elk
notities samenvoegstrategie.

--verbinden
Rond een lopende af git aantekeningen samensmelten. Gebruik deze optie wanneer u het probleem hebt opgelost
strijdt dat git aantekeningen samensmelten opgeslagen in .git/NOTES_MERGE_WORKTREE. Dit wijzigt de
gedeeltelijke merge commit gemaakt door git aantekeningen samensmelten (opgeslagen in .git/NOTES_MERGE_PARTIAL)
door de notities toe te voegen in .git/NOTES_MERGE_WORKTREE. De notities ref opgeslagen in de
.git/NOTES_MERGE_REF symref wordt bijgewerkt naar de resulterende commit.

--afbreken
Annuleer/reset een bezigheid git aantekeningen samensmelten, dwz een samenvoeging van notities met conflicten. Dit
verwijdert eenvoudig alle bestanden die verband houden met het samenvoegen van notities.

-q, --stil
Wees stil bij het samenvoegen van noten.

-v, --uitgebreid
Wees uitgebreider wanneer u notities samenvoegt. Rapporteer bij het snoeien van notities alle objectnamen waarvan
notities worden verwijderd.

DISCUSSIE

Commit-notities zijn blobs met extra informatie over een object (meestal information
om het bericht van een commit aan te vullen). Deze blobs zijn afkomstig uit notities refs. Een notitiereferentie is
meestal een vertakking die "bestanden" bevat waarvan de paden de objectnamen voor de objecten zijn
ze beschrijven, met enkele directoryscheidingstekens om prestatieredenen [1].

Elke nootwijziging creëert een nieuwe commit op de gespecificeerde nootreferentie. U kunt dus
inspecteer de geschiedenis van de notities door bijvoorbeeld git log -p notes/commits aan te roepen. Momenteel
het commit-bericht legt alleen vast welke bewerking de update heeft geactiveerd, en de commit
auteurschap wordt bepaald volgens de gebruikelijke regels (zie git-commit(1)). Deze gegevens
kan in de toekomst veranderen.

Het is ook toegestaan ​​dat een notitiereferentie rechtstreeks naar een boomobject verwijst, in welk geval de
geschiedenis van de notities kan worden gelezen met git log -p -g .

OPMERKINGEN MERGE STRATEGIEËN

De standaard strategie voor het samenvoegen van notities is "handmatig", die conflicterende notities in een uitcheckt
speciale werkboom voor het oplossen van notitieconflicten (.git/NOTES_MERGE_WORKTREE), en instrueert
de gebruiker om de conflicten in die werkboom op te lossen. Als de gebruiker klaar is, kan hij dat ook
voltooi de samenvoeging met git aantekeningen samensmelten --verbinden, of annuleer het samenvoegen met git aantekeningen samensmelten
--afbreken.

Gebruikers kunnen een van de volgende geautomatiseerde samenvoegstrategieën selecteren met behulp van een van beide
-s/--strategy-optie of het configureren van notes.mergeStrategy dienovereenkomstig:

"ours" lost conflicterende notities automatisch op ten gunste van de lokale versie (dwz de
huidige notities ref).

"theirs" lost notitieconflicten automatisch op ten gunste van de externe versie (dwz de
gegeven noten ref wordt samengevoegd met de huidige noten ref).

"union" lost automatisch notitieconflicten op door de lokale en de externe aaneen te schakelen
versies.

"cat_sort_uniq" is vergelijkbaar met "union", maar naast het samenvoegen van de lokale en
externe versies sorteert deze strategie ook de resulterende regels en verwijdert dubbele regels
van het resultaat. Dit komt overeen met het toepassen van de shell-pijplijn "cat | sort | uniq".
de lokale en externe versies. Deze strategie is handig als de noten een lijn volgen
formaat waar men dubbele regels in het samenvoegresultaat wil vermijden. Merk op dat als een van beide
de lokale of externe versie bevat dubbele regels voorafgaand aan het samenvoegen, deze zullen dat ook zijn
verwijderd door deze strategie voor het samenvoegen van notities.

Voorbeelden

U kunt notities gebruiken om annotaties toe te voegen met informatie die op dat moment niet beschikbaar was
commit is geschreven.

$ git notes add -m 'Getest door: Johannes Sixt[e-mail beveiligd]>' 72a144e2
$ gitshow -s 72a144e
[...]
Afgetekend door: Junio ​​C Hamano[e-mail beveiligd]>

Opmerkingen:
Getest door: Johannes Sixt[e-mail beveiligd]>

In principe is een notitie een gewone Git-blob en wordt elke vorm van (niet-)indeling geaccepteerd. Jij
kan binair veilig notities maken van willekeurige bestanden met behulp van git hash-object:

$cc *.c
$ blob=$(git hash-object -w a.out)
$ git notes --ref=built add --allow-empty -C "$blob" HEAD

(Je kunt niet zomaar git notes --ref=built add -F a.out HEAD gebruiken, want dat is het niet
binair-veilig.) Het heeft natuurlijk weinig zin om notities in niet-tekstformaat weer te geven met
git inloggen, dus als u dergelijke notities gebruikt, zult u waarschijnlijk een speciaal doel moeten schrijven
hulpmiddelen om er iets nuttigs mee te doen.

CONFIGURATIE

kern.opmerkingenRef
Notes ref om te lezen en te manipuleren in plaats van refs/notes/commits. Moet een
niet-afgekorte ref-naam. Deze instelling kan worden overschreven via de omgeving en
opdrachtregel.

notities.mergeStrategy
Welke samenvoegstrategie standaard moet worden gekozen bij het oplossen van notitieconflicten. Moet er een zijn
van handleiding, van ons, van hen, vakbond of cat_sort_uniq. Staat standaard op handmatig. Zie "NOTITIES SAMENVOEGEN
STRATEGIEËN" hierboven voor meer informatie over elke strategie.

Deze instelling kan worden overschreven door de optie --strategy door te geven.

notities. .mergeStrategie
Welke samenvoegstrategie te kiezen bij het samenvoegen van notities in refs/notes/ . Dit
heft de meer algemene "notes.mergeStrategy" op. Zie de "NOTES MERGE STRATEGIEËN"
sectie hierboven voor meer informatie over elke beschikbare strategie.

notities.displayRef
Welke ref (of refs, indien een glob of meer dan eens gespecificeerd), naast de standaard
ingesteld door core.notesRef of GIT_NOTES_REF, om notities te lezen van bij het tonen van commit-berichten
met de git inloggen familie van commando's. Deze instelling kan worden overschreven met de opdracht
lijn of door de GIT_NOTES_DISPLAY_REF omgevingsvariabele. Zien git-log(1).

notities.herschrijven.
Bij het herschrijven van commits met (momenteel wijzigen of rebaseen), als deze variabele is
false, zal git geen notities kopiëren van het origineel naar de herschreven commit. Standaard naar
WAAR. Zie ook "notes.rewriteRef" hieronder.

Deze instelling kan worden overschreven door de GIT_NOTES_REWRITE_REF variabele omgeving.

notities.herschrijvenMode
Wat te doen als de doelcommit al een
opmerking. Moet een van de volgende zijn: overschrijven, samenvoegen, cat_sort_uniq of negeren. Standaard naar
samenvoegen.

Deze instelling kan worden overschreven met de omgevingsvariabele GIT_NOTES_REWRITE_MODE.

notities.herschrijvenRef
Bij het kopiëren van notities tijdens een herschrijving, specificeert de (volledig gekwalificeerde) ref wiens notities
moet worden gekopieerd. Kan een bol zijn, in welk geval notities in alle overeenkomende refs zullen zijn
gekopieerd. U kunt deze configuratie ook meerdere keren opgeven.

Heeft geen standaardwaarde; u moet deze variabele configureren om notitie in te schakelen
herschrijven.

Kan worden overschreven met de GIT_NOTES_REWRITE_REF variabele omgeving.

MILIEU

GIT_NOTES_REF
Van welke ref notities moeten worden gemanipuleerd, in plaats van refs/notes/commits. Dit overschrijft de
core.notesRef-instelling.

GIT_NOTES_DISPLAY_REF
Door dubbele punten gescheiden lijst van refs of globs die aangeven welke refs, naast de
standaard van core.notesRef of GIT_NOTES_REF, om notities te lezen van bij het tonen van commit
berichten. Dit heft de instelling notes.displayRef op.

Er wordt een waarschuwing gegeven voor refs die niet bestaan, maar een glob die niet overeenkomt
eventuele scheidsrechters worden stilzwijgend genegeerd.

GIT_NOTES_REWRITE_MODE
Wat te doen als de doelcommit al een
opmerking. Moet een van de volgende zijn: overschrijven, samenvoegen, cat_sort_uniq of negeren. Dit overschrijft
de instelling core.rewriteMode.

GIT_NOTES_REWRITE_REF
Bij het herschrijven van commits, welke notities gekopieerd moeten worden van het origineel naar de herschreven commit.
Moet een door dubbele punten gescheiden lijst van refs of globs zijn.

Indien niet ingesteld in de omgeving, hangt de lijst met te kopiëren notities af van de
notities.herschrijven. en notes.rewriteRef-instellingen.

GIT

Een deel van de git(7) Suite

OPMERKINGEN

1. Toegestane padnamen hebben de vorm ab/cd/ef/.../abcdef...: een reeks mappen
namen van twee hexadecimale cijfers, elk gevolgd door een bestandsnaam met de rest van de
object-ID.

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