git-describe - Online nel cloud

PROGRAMMA:

NOME

git-describe - Descrivi un commit utilizzando il tag più recente raggiungibile da esso

SINOSSI

git descrivere [--all] [--tags] [--contains] [--abbrev= ] [ ...]
git descrivere [--all] [--tags] [--contains] [--abbrev= ] --dirty[= ]

DESCRIZIONE

Il comando trova il tag più recente raggiungibile da un commit. Se il tag punta
al commit, viene mostrato solo il tag. Altrimenti, aggiunge al nome del tag il suffisso
numero di commit aggiuntivi sopra l'oggetto taggato e il nome dell'oggetto abbreviato
del commit più recente.

Per impostazione predefinita (senza --all o --tags) git description mostra solo tag annotati. Per più
informazioni sulla creazione di tag annotati vedere le opzioni -a e -s per tag git(1).

VERSIONI

...
Nomi di oggetti commessi da descrivere. Il valore predefinito è HEAD se omesso.

--sporco[= ]
Descrivi l'albero di lavoro. Significa descrivere HEAD e aggiunge (-sporco di
default) se l'albero di lavoro è sporco.

--tutti
Invece di usare solo i tag annotati, usa qualsiasi riferimento trovato in refs/ namespace. Questo
L'opzione consente la corrispondenza con qualsiasi ramo noto, ramo di tracciamento remoto o tag leggero.

--tag
Invece di usare solo i tag annotati, usa qualsiasi tag trovato nello spazio dei nomi refs/tags.
Questa opzione consente di abbinare un tag leggero (non annotato).

--contiene
Invece di trovare il tag che precede il commit, trova il tag che viene dopo il
commit, e quindi lo contiene. Implica automaticamente --tags.

--abbrev=
Invece di usare le 7 cifre esadecimali predefinite come nome dell'oggetto abbreviato, usa
cifre o il numero di cifre necessario per formare un nome oggetto univoco. Un di 0 sarà
sopprime il formato lungo, mostrando solo il tag più vicino.

--candidates=
Invece di considerare solo i 10 tag più recenti come candidati per descrivere il
input commit-ish considerare fino a candidati. Crescente sopra 10 prenderà
leggermente più lungo ma può produrre un risultato più accurato. Un di 0 causerà solo
corrispondenze esatte da produrre.

--corrispondenza esatta
Produce solo corrispondenze esatte (un tag fa riferimento direttamente al commit fornito). Questo è un
sinonimo di --candidates=0.

- debug
Visualizzare in modo dettagliato le informazioni sulla strategia di ricerca impiegata secondo gli standard
errore. Il nome del tag verrà comunque stampato su standard out.

--lungo
Emetti sempre il formato lungo (il tag, il numero di commit e l'abbreviato
commit name) anche quando corrisponde a un tag. Questo è utile quando vuoi vedere parti di
il nome dell'oggetto commit nell'output "descrivi", anche quando si verifica il commit in questione
essere una versione etichettata. Invece di emettere semplicemente il nome del tag, descriverà tale
commit come v1.2-0-gdeadbee (0° commit dal tag v1.2 che punta all'oggetto
ape morta...).

--incontro
Considera solo i tag che corrispondono al dato glob(7) modello, escludendo "refs/tags/"
prefisso. Questo può essere usato per evitare la perdita di tag privati ​​dal repository.

--sempre
Mostra l'oggetto commit abbreviato in modo univoco come fallback.

--primogenitore
Segui solo il primo commit padre quando vedi un commit di unione. Questo è utile quando
desideri non abbinare i tag sui rami uniti nella cronologia del commit di destinazione.

ESEMPI

Con qualcosa come l'albero corrente git.git, ottengo:

[torvalds@g5 git]$ git descrivere genitore
v1.0.4-14-g2414721

cioè l'attuale capo del mio ramo "genitore" è basato su v1.0.4, ma poiché ne ha alcuni
commit oltre a quello, description ha aggiunto il numero di commit aggiuntivi ("14") e an
nome dell'oggetto abbreviato per il commit stesso ("2414721") alla fine.

Il numero di commit aggiuntivi è il numero di commit che verrebbe visualizzato da "git
log v1.0.4..parent". Il suffisso hash è "-g" + abbreviazione di 7 caratteri per il commit tip di
genitore (che era 2414721b194453f058079d897d13c4e377f92dc6). Il prefisso "g" sta per
"git" e viene utilizzato per consentire di descrivere la versione di un software a seconda dell'SCM il
software è gestito con. Questo è utile in un ambiente in cui le persone possono usare diversi
SCM.

Fare a git descrivere su un tag-name mostrerà solo il nome del tag:

[torvalds@g5 git]$ git descrivere v1.0.4
v1.0.4

Con --all, il comando può usare le intestazioni dei rami come riferimenti, quindi l'output mostra il
anche il percorso di riferimento:

[torvalds@g5 git]$ git descrivere --all --abbrev=4 v1.0.5^2
tag/v1.0.0-21-g975b

[torvalds@g5 git]$ git descrivere --all --abbrev=4 TESTA^
teste/lt/descrivi-7-g975b

Con --abbrev impostato su 0, il comando può essere utilizzato per trovare il nome del tag più vicino senza nessuno
suffisso:

[torvalds@g5 git]$ git descrivere --abbrev=0 v1.0.5^2
tag/v1.0.0

Nota che il suffisso che ottieni se digiti questi comandi oggi potrebbe essere più lungo di quanto
Linus ha visto sopra quando ha eseguito questi comandi, poiché il tuo repository Git potrebbe avere nuovi commit
i cui nomi di oggetti iniziano con 975b che allora non esisteva e solo il suffisso "-g975b"
potrebbe non essere sufficiente per disambiguare questi commit.

RICERCA STRATEGIA

Per ogni commit-ish fornito, git descrivere cercherà prima un tag che tagga esattamente
che si impegna. I tag annotati saranno sempre preferiti ai tag leggeri e ai tag con
le date più recenti saranno sempre preferite ai tag con date più vecchie. Se una corrispondenza esatta è
trovato, il suo nome verrà emesso e la ricerca si fermerà.

Se non è stata trovata una corrispondenza esatta, git descrivere ripercorrerà la cronologia dei commit a
individuare un commit antenato che è stato taggato. Il tag dell'antenato verrà emesso insieme
con un'abbreviazione di SHA-1 dell'input commit-ish. Se --primogenitore è stato specificato allora
la passeggiata prenderà in considerazione solo il primo genitore di ogni commit.

Se sono stati trovati più tag durante la passeggiata, il tag con il minor numero di commit
diverso dall'input commit-ish verrà selezionato ed emesso. Qui il minor numero di commit
differente è definito come il numero di commit che verrebbe mostrato da git log tag..input
sarà il minor numero possibile di commit.

GIT

Parte della git(1) seguito

Usa git-describe online utilizzando i servizi onworks.net