Svenska ▾ Topics ▾ Latest version ▾ git-notes last updated in 2.50.0

NAMN

git-notes - Lägg till eller inspektera objektanteckningar

SYNOPSIS

git notes [list [<objekt>]]
git notes add [-f] [--allow-empty] [--[no-]separator | --separator=<styckebrytning>] [--[no-]stripspace] [-F <file> | -m <medd> | (-c | -C) <objekt>] [-e] [<objekt>]
git notes copy [-f] ( --stdin | <from-object> [<to-object>] )
git notes append [--allow-empty] [--[no-]separator | --separator=<styckebrytning>] [--[no-]stripspace] [-F <file> | -m <medd> | (-c | -C) <objekt>] [-e] [<objekt>]
git notes edit [--allow-empty] [<object>] [--[no-]stripspace]
git notes show [<objekt>]
git notes merge [-v | -q] [-s <strategi> ] <antecknings-ref>
git notes merge --commit [-v | -q]
git notes merge --abort [-v | -q]
git notes remove [--ignore-missing] [--stdin] [<objekt>…​]
git notes prune [-n] [-v]
git notes get-ref

BESKRIVNING

Lägger till, tar bort eller läser anteckningar som är kopplade till objekt, utan att röra själva objekten.

Som standard sparas anteckningar till och läses från refs/notes/commits, men standardinställningen kan åsidosättas. Se avsnitten ALTERNATIV, KONFIGURATION och MILJÖ nedan. Om referensen inte finns skapas den tyst när den först behövs för att lagra en anteckning.

En typisk användning av anteckningar är att komplettera ett incheckningsmeddelande utan att ändra själva incheckningen. Anteckningar kan visas av git log tillsammans med det ursprungliga incheckningsmeddelandet. För att skilja anteckningarna från meddelandet i incheckningsobjektet visas de indragna som meddelandet, efter en oindragen rad som säger "Anteckningar (<refnamn>):" (eller "Anteckningar:" för refs/notes/commits).

Anteckningar kan också läggas till patchar som förberetts med git format-patch genom att använda alternativet --notes. Sådana anteckningar läggs till som en patchkommentar efter en separatorrad med tre streck.

För att ändra vilka anteckningar som visas av git log, se avsnittet om notes.displayRef i KONFIGURATION.

Se konfigurationen notes.rewrite.<kommando> för ett sätt att överföra anteckningar mellan kommandon som skriver om incheckningar.

UNDERKOMMANDON

list

Lista anteckningsobjektet för ett givet objekt. Om inget objekt anges visas en lista över alla anteckningsobjekt och de objekt de annoterar (i formatet "<anteckningsobjekt> <annoterat-objekt>"). Detta är standardunderkommandot om inget underkommando anges.

add

Lägg till anteckningar för ett givet objekt (standard är HEAD). Avbryt om objektet redan har anteckningar (använd -f för att skriva över befintliga anteckningar). Om du däremot använder add interaktivt (med en redigerare för att ange anteckningens innehåll) öppnas de befintliga anteckningarna i redigeraren (som med underkommandot edit). Om du anger flera -m och -F infogas en tom rad mellan meddelandena. Använd --separator för andra avgränsare. Du kan använda -e för att redigera och finjustera meddelanden från -m och -F interaktivt innan anteckningen läggs till.

copy

Kopiera anteckningarna från det första objektet till det andra objektet (standard är HEAD). Avbryt om det andra objektet redan har anteckningar, eller om det första objektet saknar anteckningar (använd -f för att skriva över befintliga anteckningar på det andra objektet). Detta underkommando motsvarar: git notes add [-f] -C $(git notes list <från-objekt>) <till-objekt>.

I --stdin-läge, ta rader i formatet

<från-objekt> SP <till-objekt> [ SP <rest> ] LF

på standardinmatning, och kopiera anteckningarna från varje <från-objekt> till motsvarande <till-objekt>. (Valfria <rest> ignoreras så att kommandot kan läsa inmatning som ges till kroken post-rewrite.)

--stdin kan inte kombineras med objektnamn som anges på kommandoraden.

append

Lägg till nya meddelanden som anges med -m eller -F till en befintlig anteckning, eller lägg till dem som en ny anteckning om ingen finns, för objektet (standard är HEAD). När meddelanden läggs till i en befintlig anteckning infogas en tom rad före varje nytt meddelande som avgränsare mellan stycken. Avgränsaren kan anpassas med --separator. Redigera anteckningarna som ska läggas till med -m och -F interaktivt med -e innan anteckningen läggs till.

edit

Redigera anteckningarna för ett givet objekt (standardinställningen är HEAD).

show

Visa anteckningarna för ett givet objekt (standardinställningen är HEAD).

merge

Sammanfoga den angivna anteckningsreferensen med den aktuella anteckningsreferensen. Detta försöker sammanfoga ändringarna som gjorts av den angivna anteckningsreferensen (kallad "fjärr") sedan sammanslagningsbasen (om någon) in i den aktuella anteckningsreferensen (kallad "lokal").

Om konflikter uppstår och ingen strategi för automatisk lösning av motstridiga anteckningar anges (se avsnittet "ANTECKNINGSSAMMANSLAGNINGSSTRATEGIER") används lösaren manual. Denna lösare checkar ut de motstridiga anteckningarna i ett särskilt arbetsträd (.git/NOTES_MERGE_WORKTREE) och instruerar användaren att lösa konflikterna manuellt där. När det är klart kan användaren antingen slutföra sammanslagningen med git notes merge --commit eller avbryta den med