git-rev-parse - Online în cloud

PROGRAM:

NUME

git-rev-parse - Alegeți și masați parametrii

REZUMAT

merge rev-parse [ --opțiune ] ...

DESCRIERE

Multe comenzi Git porcelainish preiau un amestec de steaguri (adică parametrii care încep cu a
liniuţă -) și parametri menționați pentru subiacent merge rev-list comanda pe care o folosesc intern
și steaguri și parametri pentru celelalte comenzi pe care le folosesc în aval merge rev-list. Acest
comanda este folosită pentru a distinge între ele.

OPŢIUNI

Ziua Operației Moduri
Fiecare dintre aceste opțiuni trebuie să apară mai întâi pe linia de comandă.

--parseopt
Utilizare merge rev-parse în modul de analizare a opțiunilor (vezi secțiunea PARSEOPT de mai jos).

--citat-pat
Utilizare merge rev-parse în modul shell quoting (vezi secțiunea SQ-QUOTE de mai jos). In contrast cu
opțiunea --sq de mai jos, acest mod face doar ghilimele. Nu se face nimic altceva pentru a comanda
intrare.

Opţiuni pentru --parseopt
--ține-dashdash
Numai semnificativ în modul --parseopt. Spune analizorului de opțiuni să ecou primul --
întâlnit în loc să-l omite.

--stop-la-non-opțiune
Numai semnificativ în modul --parseopt. Permite analizatorului de opțiuni să se oprească la primul
argument non-opțiune. Aceasta poate fi folosită pentru a analiza sub-comenzi care acceptă opțiuni
înșiși.

--blocat-de-lung
Numai semnificativ în modul --parseopt. Ieșiți opțiunile în forma lor lungă dacă
disponibile și cu argumentele lor blocate.

Opţiuni pentru Filtrare
--doar turații
Nu scoateți semnale și parametri care nu sunt destinati merge rev-list comanda.

--fără turații
Nu scoateți steaguri și parametrii destinați merge rev-list comanda.

--steaguri
Nu scoateți parametri care nu sunt semnalizați.

--fără-steaguri
Nu scoateți parametri de semnalizare.

Opţiuni pentru producție
--Mod implicit
Dacă nu există niciun parametru dat de utilizator, utilizați in schimb.

--prefix
Comportă-te ca și cum merge rev-parse a fost invocat din subdirectorul de lucru
copac. Orice nume de fișiere relative sunt rezolvate ca și cum ar fi prefixate de si va fi
tipărite în această formă.

Aceasta poate fi folosită pentru a converti argumentele într-o comandă rulată într-un subdirector, astfel încât acestea
poate fi folosit în continuare după trecerea la nivelul superior al depozitului. De exemplu:

prefix=$(git rev-parse --show-prefix)
cd „$(git rev-parse --show-toplevel)”
eval "set -- $(git rev-parse --sq --prefix "$prefix" "$@")"

--verifica
Verificați dacă este furnizat exact un parametru și că poate fi transformat într-un parametru brut
SHA-20 de 1 de octeți care poate fi utilizat pentru a accesa baza de date de obiecte. Dacă da, emite-l către
ieșire standard; altfel, eroare.

Dacă doriți să vă asigurați că rezultatul numește de fapt un obiect din obiectul dvs
baza de date și/sau poate fi folosit ca un anumit tip de obiect de care aveți nevoie, puteți adăuga
^{type} operator de peeling la parametru. De exemplu, git rev-parse „$VAR^{commit}”
se va asigura că $VAR numește un obiect existent care este un commit-ish (adică un commit sau
o etichetă adnotată care indică un commit). Pentru a vă asigura că $VAR numește un existent
obiect de orice tip, poate fi folosit git rev-parse „$VAR^{object}”.

-q, --liniște
Numai semnificativ în modul --verify. Nu afișați un mesaj de eroare dacă primul argument
nu este un nume de obiect valid; în schimb, ieșiți cu starea diferită de zero în tăcere. SHA-1 pentru
numele de obiecte valide sunt tipărite în stdout la succes.

--mp
De obicei, ieșirea este realizată cu o linie per flag și parametru. Această opțiune face ieșire a
o singură linie, cotată în mod corespunzător pentru consumul de shell. Util atunci când vă așteptați
parametru pentru a conține spații albe și linii noi (de exemplu, când utilizați pickaxe -S cu merge
dif-*). Spre deosebire de opțiunea --sq-quote, intrarea comenzii este încă interpretată
ca de obicei.

--nu
Când afișați numele obiectelor, prefixați-le cu ^ și bandă ^ prefix din numele obiectelor
care au deja unul.

--abbrev-ref[=(strict|loose)]
Un nume scurt neambiguu al numelui obiectelor. Opțiunea core.warnAmbiguousRefs este
folosit pentru a selecta modul strict de abreviere.

--short, --short=număr
În loc să scoateți valorile SHA-1 complete ale numelor de obiecte, încercați să le abreviați la
un nume unic mai scurt. Când nu este specificată lungimea, se utilizează 7. Lungimea minima este de 4.

--simbolic
De obicei, numele obiectelor sunt scoase în formă SHA-1 (cu posibil ^ prefix); acest
opțiunea le face să iasă într-o formă cât mai apropiată de intrarea originală.

--nume-complet-simbolic
Acest lucru este similar cu --symbolic, dar omite intrările care nu sunt refs (adică ramuri sau
nume de etichete; sau mai explicit dezambiguizarea formularului „șefi/master”, atunci când doriți
denumește ramura „master” când există o etichetă numită, din păcate, „master”) și arată
ele ca refname complete (de exemplu, "refs/heads/master").

Opţiuni pentru Obiecte
--toate
Afișați toate referințele găsite în refs/.

--branches[=pattern], --tags[=pattern], --remotes[=pattern]
Afișați toate ramurile, etichetele sau ramurile de urmărire la distanță, respectiv (adică, referințe găsite
în refs/heads, refs/tag-uri sau, respectiv, referințe/telecomenzi).

Dacă este dat un model, sunt afișate doar referințele care se potrivesc cu globul de shell dat. Dacă
modelul nu conține un caracter globbing (?, * sau [), este transformat într-un prefix
potriviți prin adăugarea /*.

--glob=model
Afișați toate referințele care se potrivesc cu modelul shell glob. Dacă modelul nu începe
cu refs/, aceasta este adăugată automat. Dacă modelul nu conține a
caracter globbing (?, * sau [), este transformat într-o potrivire de prefix prin adăugarea /*.

--exclude=
Nu includeți potrivirea referințelor că următoarele --toate, --ramuri, --etichete,
--remotes sau --glob ar lua în considerare altfel. Repetările acestei opțiuni se acumulează
modele de excludere până la următorul --all, --branches, --tags, --remotes sau --glob
opțiune (alte opțiuni sau argumente nu șterg tiparele acumulate).

Modelele date nu trebuie să înceapă cu refs/heads, refs/tags sau refs/remotes atunci când
aplicat la --branches, --tag-uri sau, respectiv, --remotes și trebuie să înceapă cu
refs/ când se aplică la --glob sau --all. Dacă o urmă /* este destinat, trebuie dat
explicit.

--disambiguate=
Afișați fiecare obiect al cărui nume începe cu prefixul dat. The trebuie să fie la
cel puțin 4 cifre hexazecimale pentru a evita listarea fiecărui obiect din
depozit din greșeală.

Opţiuni pentru Fişiere
--local-env-vars
Listați variabilele de mediu GIT_* care sunt locale pentru depozit (de exemplu, GIT_DIR sau
GIT_WORK_TREE, dar nu GIT_EDITOR). Sunt enumerate doar numele variabilelor, nu
valoarea lor, chiar dacă sunt setate.

--git-dir
Afișați $GIT_DIR dacă este definit. În caz contrar, arată calea către directorul .git. Calea
afișat, când este relativ, este relativ la directorul de lucru curent.

Dacă $GIT_DIR nu este definit și directorul curent nu este detectat că se află într-un Git
depozitul sau arborele de lucru tipăriți un mesaj către stderr și ieșiți cu starea diferită de zero.

--git-common-dir
Afișați $GIT_COMMON_DIR dacă este definit, altfel $GIT_DIR.

--este-în interiorul-git-dir
Când directorul de lucru curent se află sub directorul de depozit, se afișează „adevărat”,
altfel „fals”.

--este-înăuntru-arborele-de-lucru
Când directorul de lucru curent se află în arborele de lucru al magaziei de imprimare
„adevărat”, altfel „fals”.

--is-bare-repository
Când depozitul este tipărit liber „adevărat”, altfel „fals”.

--resolve-git-dir
Verifica daca este un depozit valid sau un fișier git care indică un depozit valid,
și tipăriți locația depozitului. Dacă este un fișier git, apoi rezolvat
calea către depozitul real este tipărită.

--git-path
Rezolvați „$GIT_DIR/ " și preia alte variabile de relocare a căii, cum ar fi
$GIT_OBJECT_DIRECTORY, $GIT_INDEX_FILE... în considerare. De exemplu, dacă
$GIT_OBJECT_DIRECTORY este setat la /foo/bar apoi „git rev-parse --git-path objects/abc”
returnează /foo/bar/abc.

--show-cdup
Când comanda este invocată dintr-un subdirector, afișați calea nivelului superior
director relativ la directorul curent (de obicei, o secvență de „../”, sau un
Șir gol).

--arata-prefix
Când comanda este invocată dintr-un subdirector, afișați calea curentului
director relativ la directorul de nivel superior.

--show-topplevel
Afișați calea absolută a directorului de nivel superior.

--shared-index-path
Afișați calea către fișierul index partajat în modul index divizat sau goală dacă nu este
modul split-index.

Altele Opţiuni
--since=datastring, --after=datastring
Analizați șirul de date și afișați parametrul --max-age= corespunzător pentru merge
rev-list.

--until=datastring, --before=datastring
Analizați șirul de date și afișați parametrul --min-age= corespunzător pentru merge
rev-list.

...
Indicatori și parametri care urmează să fie analizați.

SPECIFICAREA REVIZII

Un parametru de revizuire de obicei, dar nu neapărat, denumește un obiect commit. Folosește
ceea ce se numeste an extins SHA-1 sintaxă. Iată diferite moduri de a scrie numele obiectelor. The
cele listate aproape de sfârșitul acestei liste numesc arbori și blob-uri conținute într-un commit.

, de exemplu dae86e1950b1277e545cee180551750029cfe735, dae86e
Numele complet al obiectului SHA-1 (șir hexazecimal de 40 de octeți) sau un subșir principal care
este unic în cadrul depozitului. De exemplu, dae86e1950b1277e545cee180551750029cfe735 și
dae86e numesc ambele același obiect de comitere dacă nu există niciun alt obiect în depozitul dumneavoastră
al cărui nume de obiect începe cu dae86e.

, de exemplu v1.7.4.2-679-g3bee7fb
Ieșire de la git describe; adică cea mai apropiată etichetă, urmată opțional de o liniuță și a
numărul de comite, urmat de o liniuță, a g, și un nume de obiect abreviat.

, de exemplu maestru, șefi/master, refs/şefi/master
Un nume de referință simbolic. De exemplu maestru înseamnă de obicei obiectul de comitere la care face referire
refs/şefi/master. Dacă se întâmplă să le ai pe amândouă șefi/master și tag-uri/master, Aveți posibilitatea să
spune explicit șefi/master pentru a-i spune lui Git la care te referi. Când este ambiguu, a
este dezambiguizat prin luarea primului meci în următoarele reguli:

1. Dacă $GIT_DIR/ există, asta vrei să spui (de obicei este util doar
pentru HEAD, FETCH_HEAD, ORIG_HEAD, MERGE_HEAD și CHERRY_PICK_HEAD);

2. altfel, refs/ dacă există;

3. altfel, refs/etichete/ dacă există;

4. altfel, arbitri/capete/ dacă există;

5. altfel, refs/telecomenzi/ dacă există;

6. altfel, refs/telecomenzi/ /CAP dacă există.

HEAD numește commit-ul pe care ați bazat modificările în arborele de lucru.
FETCH_HEAD înregistrează ramura pe care ați preluat-o dintr-un depozit la distanță cu dvs
ultima invocare git fetch. ORIG_HEAD este creat de comenzi care vă mută HEAD
într-un mod drastic, pentru a înregistra poziția lui HEAD înainte de operarea lor, deci
că poți schimba cu ușurință vârful crengii înapoi la starea de dinainte de a alerga
Le. MERGE_HEAD înregistrează comite-urile pe care le fuzionați în ramura dvs
când rulați git merge. CHERRY_PICK_HEAD înregistrează comiterea care ești
cherry-picking când rulați git cherry-pick.

Rețineți că oricare dintre refs/* cazurile de mai sus pot proveni fie din $GIT_DIR/ref
director sau din $GIT_DIR/ref.-ambalate fişier. În timp ce codificarea numelui de referință este
nespecificat, UTF-8 este preferat deoarece unele procesări de ieșire pot presupune nume de ref
UTF-8.

@
@ singur este o scurtătură pentru HEAD.

@{ }, de exemplu maestru@{ieri}, CAP@{5 minute în urmă}
Un ref urmat de sufix @ cu o specificație de dată inclusă într-o pereche de bretele
(de exemplu {ieri}, {1 lună 2 săptămâni 3 zile 1 oră 1 al doilea în urmă} or {1979-02-26
18:30:00}) specifică valoarea ref la un moment anterior din timp. Acest sufix poate
poate fi utilizat numai imediat după un nume de referință, iar referința trebuie să aibă un jurnal existent
($GIT_DIR/logs/). Rețineți că aceasta caută starea dvs local ref la un dat
timp; de exemplu, ce a fost în localul dvs maestru filiala saptamana trecuta. Daca vrei sa te uiti
comite făcute în anumite perioade, vezi --de cand și --pana cand.

@{ }, de exemplu master@{1}
Un ref urmat de sufix @ cu o specificație ordinală inclusă într-o pereche de bretele
(de exemplu 1 {}, 15 {}) specifică a n-a valoare anterioară a acelei ref. De exemplu master@{1}
este valoarea anterioară imediată a maestru în timp ce master@{5} este a 5-a valoare anterioară a
maestru. Acest sufix poate fi utilizat numai imediat după un nume de ref, iar ref trebuie
au un jurnal existent ($GIT_DIR/logs/).

@{ }, de exemplu @{1}
Aveți posibilitatea să utilizați @ construiți cu o parte ref goală pentru a ajunge la o intrare reflog a
ramura actuală. De exemplu, dacă sunteți pe ramură blabla apoi @{1} înseamnă la fel ca
blabla@{1}.

@{- }, de exemplu @{-1}
Construcția @{- } înseamnă a-lea ramură/comite a fost verificată înainte de curent
unul.

@{amonte}, de exemplu master@{amonte}, @{u}
Sufixul @{amonte} la un nume de ramură (forma scurtă @{u}) se referă la
ramură pe care ramura specificată de branchname este setată să se construiască deasupra (configurată
cu ramură. .telecomandă și ramură. .combina). Un nume de ramură lipsă este implicit
cea actuală.

@{Apăsaţi}, de exemplu master@{push}, @{Apăsaţi}
Sufixul @{Apăsaţi} raportează ramura „unde am împinge” dacă git push ar fi rulat
în timp ce branchname a fost verificat (sau curentul HEAD dacă nu este specificat niciun nume de ramură).
Deoarece destinația noastră push este într-un depozit la distanță, desigur, raportăm local
urmărire ramură care corespunde acelei ramuri (adică ceva în refs/telecomenzi/).

Iată un exemplu pentru a fi mai clar:

$ git config push.default curent
$ git config remote.pushdefault myfork
$ git checkout -b mybranch origine/master

$ git rev-parse --symbolic-full-name @{upstream}
refs/telecomenzi/origine/master

$ git rev-parse --symbolic-full-name @{push}
refs/remotes/myfork/mybranch

Rețineți în exemplu că am configurat un flux de lucru triunghiular, de unde tragem de la unul
locație și împingeți în alta. Într-un flux de lucru non-triunghiular, @{Apăsaţi} este la fel ca
@{amonte}, și nu este nevoie de el.

^, de exemplu CAP^, v1.5.1^0
Un sufix ^ la un parametru de revizuire înseamnă primul părinte al acelui obiect de comitere. ^
înseamnă al-lea părinte (ex ^ este echivalent cu ^1). Ca o regulă specială,
^0 înseamnă commit-ul în sine și este folosit când este numele obiectului unei etichete
obiect care se referă la un obiect commit.

~, de exemplu maestru~3
Un sufix ~ la un parametru de revizuire înseamnă obiectul commit care este th
strămoșul de generație al obiectului numit commit, urmând doar primii părinți. ie
~3 este echivalent cu ^^^ care echivalează cu ^1^1^1. Vezi mai jos pentru un
ilustrare a utilizării acestei forme.

^{ }, de exemplu v0.99.8^{commit}
Un sufix ^ urmat de un nume de tip de obiect inclus într-o pereche de acolade înseamnă dereferire
obiectul la recursiv până la un obiect de tip este găsit sau obiectul
nu mai poate fi dereferențiat (caz în care, barf). De exemplu, dacă este
se angajează, ^{commit} descrie obiectul de comitere corespunzător. În mod similar, dacă
este un copac, ^{copac} descrie obiectul arborescent corespunzător. ^0 is
o prescurtare pentru ^{commit}.

rev^{obiect} poate fi folosit pentru a vă asigura rev denumește un obiect care există, fără
necesită rev să fie o etichetă și fără dereferențiere rev; deoarece o etichetă este deja o
obiect, nu trebuie să fie dereferențiat nici măcar o dată pentru a ajunge la un obiect.

rev^{etichetă} poate fi folosit pentru a se asigura că rev identifică un obiect etichetă existent.

^{}, de exemplu v0.99.8^{}
Un sufix ^ urmat de o pereche de acolade goală înseamnă că obiectul ar putea fi o etichetă și
dereferiți eticheta în mod recursiv până când este găsit un obiect fără etichetă.

^{/ }, de exemplu HEAD^{/fix urât gândac}
Un sufix ^ la un parametru de revizuire, urmat de o pereche de acolade care conține un led text
printr-o bară oblică, este la fel ca :/remediază urât bug sintaxa de mai jos, cu excepția faptului că returnează
cel mai tânăr commit de potrivire care este accesibil de la înainte ^.

:/, de exemplu :/remediază urât bug
Punctele două puncte, urmate de o bară oblică, urmate de un text, numesc un commit al cărui mesaj de comitere
se potrivește cu expresia regulată specificată. Acest nume returnează cea mai tânără potrivire
commit care este accesibil de la orice ref. Dacă mesajul de confirmare începe cu a ! tu
trebuie să repet asta; secvența specială :/!, urmat de altceva decât !, Este
rezervat pentru moment. Expresia regulată se poate potrivi cu orice parte a mesajului de confirmare. La
potriviți mesajele care încep cu un șir, se pot folosi de ex :/^foo.

:, de exemplu CAP: CITEȘTE-MĂ, :CITEȘTE-MĂ, master:./README
Un sufix : urmat de o cale denumește blob-ul sau arborele la calea dată în tree-ish
obiect numit de partea dinaintea punctelor. :cale (cu o parte goală înainte de
două puncte) este un caz special al sintaxei descrise în continuare: conținut înregistrat în index
la calea dată. Un drum care începe cu ./ or .. / este relativ la funcționarea curentă
director. Calea dată va fi convertită în raport cu rădăcina arborelui de lucru
director. Acest lucru este cel mai util pentru a aborda un blob sau un arbore dintr-un commit sau un arbore care
are aceeași structură de arbore ca arborele de lucru.

: :, de exemplu :0:CITIȚI-MĂ, :CITEȘTE-MĂ
Un două puncte, urmate opțional de un număr de etapă (de la 0 la 3) și două puncte, urmate de a
cale, denumește un obiect blob în index la calea dată. Lipsește un număr de etapă (și
punctele care îi urmează) denumesc o intrare din stadiul 0. În timpul unei fuziuni, etapa 1 este
strămoș comun, etapa 2 este versiunea ramurii țintă (de obicei cea actuală
ramură), iar etapa 3 este versiunea din ramura care este îmbinată.

Iată o ilustrație, de Jon Loeliger. Ambele nodurile de commit B și C sunt părinți ai commit-ului
nodul A. Comiterile părinte sunt ordonate de la stânga la dreapta.

GHIJ
\ / \ /
DEF
\ | /\
\ | / |
\|/ |
BC
\/
\/
A

A = = A^0
B = A^ = A^1 = A~1
C = A^2 = A^2
D = A^^ = A^1^1 = A~2
E = B^2 = A^^2
F = B^3 = A^^3
G = A^^^ = A^1^1^1 = A~3
H = D^2 = B^^2 = A^^^2 = A~2^2
I = F^ = B^3^ = A^^3^
J = F^2 = B^3^2 = A^^3^2

SPECIFICAREA GAMA

Comenzile de parcurgere a istoricului, cum ar fi git log, operează pe un set de comiteri, nu doar pe unul singur
comite. La aceste comenzi, specificând o singură revizuire cu notația descrisă în
secțiunea anterioară înseamnă setul de comitere accesibile din acel comit, după comitere
lanț de strămoși.

Pentru a exclude comenzile accesibile dintr-o comitere, un prefix ^ se folosește notația. De exemplu ^r1 r2 mijloace
comite accesibile de la r2 dar exclude-le pe cele accesibile din r1.

Această operație de setare apare atât de des încât există o prescurtare pentru ea. Când ai doi
comite r1 și r2 (numit conform sintaxei explicate în PRECIZAREA REVIZIUNILOR de mai sus),
puteți cere comite care sunt accesibile de la r2, cu excepția celor care sunt accesibile de la
r1 prin ^r1 r2 și se poate scrie ca r1..r2.

O notație similară r1...r2 se numeste diferenta simetrica a r1 și r2 si este definit ca
r1 r2 --nu $(git fuzionare-bază --toate r1 r2). Este setul de comite care sunt accesibile
din oricare dintre r1 or r2 dar nu din ambele.

În aceste două scurtături, puteți omite un capăt și îl lăsați implicit la HEAD. De exemplu,
origine.. este o scurtătură pentru origine..Cap și întreabă „Ce am făcut de când m-am bifurcat de la
ramură de origine?" În mod similar, ..origine este o scurtătură pentru CAP..origine și întreabă „Ce a făcut
origine de când m-am bifurcat de la ei?" Rețineți că .. ar însemna CAP.. CAP care este un gol
interval care este atât accesibil, cât și inaccesibil de la HEAD.

Alte două scurtături pentru denumirea unui set care este format dintr-un commit și commit-urile sale părinte
exista. The r1^@ notația înseamnă toți părinții de r1. r1^! include comiterea r1 dar exclude toate
a părinților săi.

Pentru a rezuma:


Includeți comisioane care sunt accesibile de la (adică strămoșii) .

^
Excludeți comiterile care sunt accesibile de la (adică strămoșii lui) .

..
Includeți comiterea de la care se poate ajunge dar excludeți-le pe cele care sunt accesibile
din . Când fie sau este omis, este implicit HEAD.

...
Includeți comiterile care sunt accesibile de la oricare sau dar exclude-le pe cele care
sunt accesibile din ambele. Când fie sau este omis, este implicit HEAD.

^@, de exemplu CAP^@
Un sufix ^ urmat de un semn la este același cu listarea tuturor părinților de
(adică includeți orice lucru accesibil de la părinți, dar nu și commit-ul în sine).

^!, de exemplu CAP^!
Un sufix ^ urmat de un semn de exclamare este același cu a da commit și apoi
toti parintii sai prefixati cu ^ pentru a-i exclude (și strămoșii lor).

Iată câteva exemple:

DGHD
DFGHIJDF
^GDHD
^DBEIJFB
B..CC
B...CGHDEBC
^DBCEIJFBC
CIJFC
C^@ IJF
C^! C
F^! DGHDF

PARSEOPT

În modul --parseopt, merge rev-parse ajută la masarea opțiunilor pentru a aduce la scripturile shell
aceleași dotări pe care le au și C builtins. Funcționează ca un normalizator de opțiuni (de exemplu, împarte un singur
schimbă valorile agregate), cam ca getopt(1) face.

Preia pe intrarea standard specificarea opțiunilor de analizat și de înțeles,
și ecou pe ieșirea standard un șir potrivit pentru sh(1) eval pentru a înlocui
argumente cu cele normalizate. În caz de eroare, emite utilizarea pe eroarea standard
stream și iese cu codul 129.

Notă: Asigurați-vă că citați rezultatul când îl treceți la eval. Vezi mai jos pentru un exemplu.

Intrare Format
merge rev-parse --parseopt formatul de intrare se bazează integral pe text. Are două părți, separate prin
o linie care conține doar --. Liniile dinaintea separatorului (ar trebui să fie una sau mai multe) sunt
folosit pentru utilizare. Liniile de după separator descriu opțiunile.

Fiecare linie de opțiuni are acest format:

* ? SP+ ajutor LF


formatul său este caracterul scurt al opțiunii, apoi numele lung al opțiunii, separat de a
virgulă. Ambele părți nu sunt necesare, deși cel puțin una este necesară. Poate să nu conțină
oricare dintre personaje. h,help, dry-run și f sunt exemple de corect
.


sunt de *, =, ? sau !.

· Utilizați = dacă opțiunea preia un argument.

· Utilizare ? pentru a însemna că opțiunea are un argument opțional. Probabil că vrei
utilizați modul --stuck-long pentru a putea analiza fără ambiguitate argumentul opțional.

· Folosiți * pentru a însemna că această opțiune nu ar trebui să fie listată în utilizarea generată pentru
-h argument. Este afișat pentru --help-all așa cum este documentat în gitcli(7).

· Utilizare ! pentru a nu face disponibilă opțiunea lungă negata corespunzătoare.


, dacă este specificat, este folosit ca nume al argumentului în rezultatul de ajutor, pentru
opțiuni care preiau argumente. este terminat de primul spațiu alb. Este
se obișnuiește să se folosească o liniuță pentru a separa cuvintele într-un indiciu de argument cu mai multe cuvinte.

Restul liniei, după îndepărtarea spațiilor, este folosit ca ajutor asociat
optiunea.

Liniile goale sunt ignorate, iar liniile care nu se potrivesc cu această specificație sunt folosite ca opțiune
anteturi de grup (începeți linia cu un spațiu pentru a crea astfel de linii intenționat).

Exemplu
OPTS_SPEC="\
unele-comandă [opțiuni] ...

unele-comandă face foo and bar!
--
h, ajută să arăți ajutorul

foo o opțiune ingenioasă --foo
bar= o opțiune grozavă --bar cu un argument
baz=arg o altă opțiune grozavă --baz cu un argument numit
qux?path qux poate lua un argument cale, dar are sens în sine

Un antet de grup de opțiuni
C? opțiunea C cu un argument opțional"

eval "$(echo "$OPTS_SPEC" | git rev-parse --parseopt -- "$@" || echo exit $?)"

Folosire a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match.
Când „$@” este -h sau --help în exemplul de mai sus, va fi afișat următorul text de utilizare:

utilizare: unele-comandă [opțiuni] ...

unele-comandă face foo and bar!

-h, --help arăta ajutorul
--foo o opțiune ingenioasă --foo
--bar ... o opțiune grozavă --bar cu un argument
--baz o altă opțiune grozavă --baz cu un argument numit
--qux[= ] qux poate lua un argument de cale, dar are sens în sine

Un antet de grup de opțiuni
-C[...] opțiunea C cu un argument opțional

CITAT-SQ

În modul --sq-quote, merge rev-parse ecou pe ieșirea standard o singură linie potrivită pentru
sh(1) eval. Această linie este realizată prin normalizarea argumentelor după --sq-quote. Nimic
altfel decât citarea argumentelor se face.

Dacă doriți ca intrarea comenzii să fie interpretată în continuare ca de obicei de merge rev-parse inainte de
ieșirea este citată de shell, vezi opțiunea --sq.

Exemplu
$ cat >your-git-script.sh <<\EOF
#!/ Bin / sh
args=$(git rev-parse --sq-quote „$@”) # citați argumente furnizate de utilizator
command="git frotz -n24 $args" # și folosiți-l în interiorul unui produs manual
# Linie de comanda
eval "$comandă"
EOF

$ sh your-git-script.sh "a b'c"

EXEMPLE

· Tipăriți numele obiectului commit-ului curent:

$ git rev-parse --verifică HEAD

· Tipăriți numele obiectului commit din revizuire în variabila shell $REV:

$ git rev-parse --verify $REV^{commit}

Acest lucru va da eroare dacă $REV este gol sau nu este o revizuire validă.

· Similar cu mai sus:

$ git rev-parse --default master --verify $REV

dar dacă $REV este gol, numele obiectului commit de la master va fi tipărit.

GIT

O parte din merge(1) apartament

Utilizați git-rev-parse online folosind serviciile onworks.net