git-rev-parse - Online sa Cloud

PROGRAMA:

NAME

git-rev-parse - Piliin at masahe ang mga parameter

SINOPSIS

pumunta rev-parse [ --opsyon ] ...

DESCRIPTION

Maraming mga Git porcelainish na utos ang kumukuha ng pinaghalong mga flag (ibig sabihin, mga parameter na nagsisimula sa a
pagsugod -) at mga parameter na sinadya para sa pinagbabatayan pumunta rev-list utos na ginagamit nila sa loob
at mga flag at parameter para sa iba pang mga utos na ginagamit nila sa ibaba ng agos pumunta rev-list. ito
Ang utos ay ginagamit upang makilala ang mga ito.

Opsyon

Operasyon Mga Mode
Ang bawat isa sa mga opsyon na ito ay dapat na unang lumitaw sa command line.

--parseopt
paggamit pumunta rev-parse sa opsyong parsing mode (tingnan ang seksyong PARSEOPT sa ibaba).

--sq-quote
paggamit pumunta rev-parse sa shell quoting mode (tingnan ang SQ-QUOTE na seksyon sa ibaba). Salungat sa
ang --sq na opsyon sa ibaba, ang mode na ito ay nag-quote lamang. Walang ibang ginagawa para mag-utos
input.

Options para --parseopt
--keep-dashdash
Makahulugan lamang sa --parseopt mode. Sinasabi sa opsyong parser na i-echo ang una --
nakilala sa halip na laktawan ito.

--stop-at-non-option
Makahulugan lamang sa --parseopt mode. Hinahayaan ang pagpipiliang parser na huminto sa una
argumentong hindi opsyon. Magagamit ito para i-parse ang mga sub-command na kumukuha ng mga opsyon
kanilang sarili.

--stuck-long
Makahulugan lamang sa --parseopt mode. I-output ang mga opsyon sa kanilang mahabang anyo kung
magagamit, at sa kanilang mga argumento natigil.

Options para Pagsasala
--revs-lamang
Huwag mag-output ng mga flag at parameter na hindi para sa pumunta rev-list utos.

--no-revs
Huwag mag-output ng mga flag at parameter na para sa pumunta rev-list utos.

--mga watawat
Huwag mag-output ng mga parameter na hindi i-flag.

--walang-bandila
Huwag mag-output ng mga parameter ng flag.

Options para Pagbubuhos
--default
Kung walang parameter na ibinigay ng user, gamitin sa halip.

--prefix
Behave as if pumunta rev-parse ay tinawag mula sa subdirectory ng nagtatrabaho
puno. Ang anumang mga kamag-anak na filename ay naresolba na parang ang mga ito ay prefix ng at magiging
nakalimbag sa pormang iyon.

Ito ay maaaring gamitin upang i-convert ang mga argumento sa isang command na tumakbo sa isang subdirectory upang sila
maaari pa ring gamitin pagkatapos lumipat sa pinakamataas na antas ng repositoryo. Halimbawa:

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

-I-verify
I-verify na eksaktong isang parameter ang ibinigay, at maaari itong gawing raw
20-byte SHA-1 na maaaring magamit upang ma-access ang object database. Kung gayon, ilabas ito sa
karaniwang output; kung hindi, error out.

Kung nais mong tiyakin na ang output ay talagang nagpapangalan ng isang bagay sa iyong bagay
database at/o maaaring gamitin bilang isang partikular na uri ng bagay na kailangan mo, maaari mong idagdag ang
^{type} peeling operator sa parameter. Halimbawa, git rev-parse "$VAR^{commit}"
ay titiyakin na pinangalanan ng $VAR ang isang umiiral na bagay na isang commit-ish (ibig sabihin, isang commit, o
isang annotated na tag na tumuturo sa isang commit). Upang matiyak na pinangalanan ng $VAR ang isang umiiral na
object ng anumang uri, git rev-parse "$VAR^{object}" ay maaaring gamitin.

-q, --tahimik
Makahulugan lamang sa --verify mode. Huwag maglabas ng mensahe ng error kung ang unang argumento
ay hindi wastong pangalan ng bagay; sa halip ay lumabas nang walang zero na katayuan nang tahimik. SHA-1 para sa
Ang mga wastong pangalan ng bagay ay naka-print upang masuri ang tagumpay.

--sq
Karaniwan ang output ay ginawa ng isang linya bawat bandila at parameter. Ang pagpipiliang ito ay gumagawa ng output a
solong linya, maayos na sinipi para sa pagkonsumo ng shell. Kapaki-pakinabang kapag inaasahan mo ang iyong
parameter na naglalaman ng mga whitespace at bagong linya (hal. kapag gumagamit ng pickaxe -S na may pumunta
diff-*). Sa kaibahan sa --sq-quote na opsyon, ang command input ay binibigyang-kahulugan pa rin
gaya ng dati.

--hindi
Kapag nagpapakita ng mga pangalan ng bagay, lagyan ng prefix ang mga ito ng ^ at maghubad ^ prefix mula sa mga pangalan ng bagay
na mayroon na.

--abbrev-ref[=(mahigpit|maluwag)]
Isang hindi malabo na maikling pangalan ng pangalan ng mga bagay. Ang opsyon core.warnAmbiguousRefs ay
ginamit upang piliin ang mahigpit na abbreviation mode.

--short, --short=number
Sa halip na i-output ang buong SHA-1 na mga halaga ng mga pangalan ng bagay, subukang paikliin ang mga ito
isang mas maikling natatanging pangalan. Kapag walang haba na tinukoy 7 ang ginagamit. Ang pinakamababang haba ay 4.

--simboliko
Karaniwan ang mga pangalan ng object ay output sa SHA-1 form (na may posible ^ prefix); ito
Ang pagpipilian ay ginagawa silang output sa isang form na malapit sa orihinal na input hangga't maaari.

--symbolic-full-name
Ito ay katulad ng --symbolic, ngunit inalis nito ang input na hindi ref (ibig sabihin, branch o
mga pangalan ng tag; o mas tahasang pag-disambiguating ng form na "heads/master", kapag gusto mo
pangalanan ang branch na "master" kapag may pangalang "master" sa kasamaang palad, at ipakita
ang mga ito bilang buong refname (hal. "refs/heads/master").

Options para bagay
--lahat
Ipakita ang lahat ng ref na matatagpuan sa ref/.

--branches[=pattern], --tags[=pattern], --remotes[=pattern]
Ipakita ang lahat ng branch, tag, o remote-tracking branch, ayon sa pagkakabanggit (ibig sabihin, nakita ang mga ref
sa mga ref/head, ref/tag, o ref/remote, ayon sa pagkakabanggit).

Kung may ibinigay na pattern, tanging mga ref na tumutugma sa ibinigay na shell glob ang ipapakita. Kung ang
pattern ay hindi naglalaman ng globbing character (?, *, o [), ito ay ginawang prefix
tugma sa pamamagitan ng pagdaragdag ng /*.

--glob= pattern
Ipakita ang lahat ng ref na tumutugma sa pattern ng shell glob pattern. Kung ang pattern ay hindi magsisimula
na may refs/, ito ay awtomatikong prepended. Kung ang pattern ay hindi naglalaman ng a
globbing character (?, *, o [), ito ay ginawang isang prefix na tugma sa pamamagitan ng pagdaragdag ng /*.

--ibukod=
Huwag isama ang mga ref na tumutugma na ang susunod na --lahat, --mga sanga, --tag,
--remotes, o --glob ay maaaring isaalang-alang. Naiipon ang mga pag-uulit ng opsyong ito
mga pattern ng pagbubukod hanggang sa susunod --lahat, --mga sanga, --tag, --remote, o --glob
opsyon (hindi nililinaw ng ibang mga opsyon o argumento ang mga naipon na pattern).

Ang mga pattern na ibinigay ay hindi dapat magsimula sa mga ref/head, ref/tag, o ref/remote kapag
inilapat sa --branches, --tags, o --remotes, ayon sa pagkakabanggit, at dapat silang magsimula sa
refs/ kapag inilapat sa --glob o --lahat. Kung isang trailing /* ay nilayon, dapat itong ibigay
tahasang

--disambiguate=
Ipakita ang bawat bagay na ang pangalan ay nagsisimula sa ibinigay na prefix. Ang dapat nasa
hindi bababa sa 4 na hexadecimal digit ang haba upang maiwasan ang paglilista ng bawat bagay sa
repository nang hindi sinasadya.

Options para File
--local-env-vars
Ilista ang mga variable ng kapaligiran ng GIT_* na lokal sa repositoryo (hal. GIT_DIR o
GIT_WORK_TREE, ngunit hindi GIT_EDITOR). Ang mga pangalan lamang ng mga variable ang nakalista, hindi
kanilang halaga, kahit na sila ay nakatakda.

--git-dir
Ipakita ang $GIT_DIR kung tinukoy. Kung hindi, ipakita ang landas sa .git na direktoryo. Ang landas
ipinapakita, kapag kamag-anak, ay nauugnay sa kasalukuyang gumaganang direktoryo.

Kung ang $GIT_DIR ay hindi tinukoy at ang kasalukuyang direktoryo ay hindi natukoy na nasa isang Git
repositoryo o work tree mag-print ng mensahe sa stderr at lumabas nang hindi zero ang status.

--git-common-dir
Ipakita ang $GIT_COMMON_DIR kung tinukoy, kung hindi, $GIT_DIR.

--is-inside-git-dir
Kapag ang kasalukuyang gumaganang direktoryo ay nasa ibaba ng direktoryo ng imbakan na naka-print na "totoo",
kung hindi ay "false".

--ay-sa-loob-trabaho-puno
Kapag ang kasalukuyang working directory ay nasa loob ng work tree ng repository print
"totoo", kung hindi "mali".

--ay-bare-repository
Kapag ang repositoryo ay hubad na naka-print na "true", kung hindi man ay "false".

--resolve-git-dir
Suriin kung ay isang wastong repositoryo o isang gitfile na tumuturo sa isang wastong repositoryo,
at i-print ang lokasyon ng repositoryo. Kung ay isang gitfile pagkatapos ay nalutas
ang landas sa totoong repositoryo ay naka-print.

--git-path
Lutasin ang "$GIT_DIR/ " at kumukuha ng iba pang mga variable ng paglipat ng landas gaya ng
$GIT_OBJECT_DIRECTORY, $GIT_INDEX_FILE... sa account. Halimbawa, kung
Nakatakda ang $GIT_OBJECT_DIRECTORY sa /foo/bar pagkatapos ay "git rev-parse --git-path objects/abc"
nagbabalik /foo/bar/abc.

--show-cdup
Kapag na-invoke ang command mula sa isang subdirectory, ipakita ang path ng pinakamataas na antas
direktoryo na nauugnay sa kasalukuyang direktoryo (karaniwang isang pagkakasunud-sunod ng "../", o isang
walang laman na string).

--show-prefix
Kapag na-invoke ang command mula sa isang subdirectory, ipakita ang path ng kasalukuyang
direktoryo na nauugnay sa nangungunang antas na direktoryo.

--show-toplevel
Ipakita ang ganap na landas ng nangungunang antas na direktoryo.

--shared-index-path
Ipakita ang path sa nakabahaging index file sa split index mode, o walang laman kung wala
split-index mode.

iba Options
--since=datestring, --after=datestring
I-parse ang string ng petsa, at i-output ang katumbas na --max-age= parameter para sa pumunta
rev-list.

--until=datestring, --before=datestring
I-parse ang string ng petsa, at i-output ang katumbas na --min-age= parameter para sa pumunta
rev-list.

...
Mga flag at parameter na i-parse.

PAGTUKOY REBISYON

Isang parameter ng rebisyon karaniwan, ngunit hindi kinakailangan, ay nagpapangalan sa isang commit object. Ito ay gumagamit ng
ano ang tinatawag na an pinahaba SHA-1 syntax. Narito ang iba't ibang paraan ng pagbaybay ng mga pangalan ng bagay. Ang
ang mga nakalista malapit sa dulo ng listahang ito ay pinangalanan ang mga puno at blobs na nasa isang commit.

, halimbawa dae86e1950b1277e545cee180551750029cfe735, dae86e
Ang buong SHA-1 object name (40-byte hexadecimal string), o isang nangungunang substring na iyon
ay natatangi sa loob ng imbakan. Hal dae86e1950b1277e545cee180551750029cfe735 at
Parehong pinangalanan ng dae86e ang parehong commit object kung walang ibang object sa iyong repository
na ang pangalan ng bagay ay nagsisimula sa dae86e.

, halimbawa v1.7.4.2-679-g3bee7fb
Output mula sa git describe; ie isang pinakamalapit na tag, opsyonal na sinusundan ng isang gitling at a
bilang ng mga commit, na sinusundan ng isang gitling, a g, at isang pinaikling pangalan ng bagay.

, halimbawa panginoon, mga pinuno/panginoon, refs/heads/master
Isang simbolikong pangalan ng ref. Hal panginoon karaniwang nangangahulugan ng commit object na tinutukoy ng
refs/heads/master. Kung mayroon kang pareho mga pinuno/panginoon at mga tag/master, Maaari mong
tahasang sabi mga pinuno/panginoon para sabihin kay Git kung alin ang ibig mong sabihin. Kapag malabo, a
ay dini-dismbiguated sa pamamagitan ng pagkuha sa unang laban sa mga sumusunod na panuntunan:

1. Kung $GIT_DIR/ umiiral, iyon ang ibig mong sabihin (karaniwan itong kapaki-pakinabang lamang
para HEAD, FETCH_HEAD, ORIG_HEAD, MERGE_HEAD at CHERRY_PICK_HEAD);

2. kung hindi, refs/ kung ito ay umiiral;

3. kung hindi, ref/tag/ kung ito ay umiiral;

4. kung hindi, refs/heads/ kung ito ay umiiral;

5. kung hindi, refs/remote/ kung ito ay umiiral;

6. kung hindi, refs/remote/ / ULO kung ito ay umiiral.

HEAD pinangalanan ang commit kung saan mo ibinatay ang mga pagbabago sa working tree.
FETCH_HEAD Itinatala ang sangay na iyong kinuha mula sa isang malayong imbakan kasama ng iyong
huling git fetch invocation. ORIG_HEAD ay nilikha ng mga utos na gumagalaw sa iyong HEAD
sa isang marahas na paraan, upang maitala ang posisyon ng HEAD bago ang kanilang operasyon, kaya
na madali mong mababago ang dulo ng sangay pabalik sa estado bago ka tumakbo
Kanila. MERGE_HEAD Itinatala ang (mga) pangako na iyong pinagsasama sa iyong sangay
kapag pinatakbo mo ang git merge. CHERRY_PICK_HEAD Itinatala ang commit kung nasaan ka
cherry-picking kapag nagpatakbo ka ng git cherry-pick.

Tandaan na alinman sa mga refs/* Ang mga kaso sa itaas ay maaaring magmula sa alinman sa $GIT_DIR/ref
direktoryo o mula sa $GIT_DIR/packed-refs file. Habang ang ref name encoding ay
hindi tinukoy, ang UTF-8 ay mas gusto dahil ang ilang pagpoproseso ng output ay maaaring maglagay ng mga pangalan ng ref
UTF-8.

@
@ nag-iisa ay isang shortcut para sa HEAD.

@{ }, halimbawa master@{kahapon}, HEAD@{5 minuto nakaraan}
Isang ref na sinusundan ng suffix @ na may kasamang detalye ng petsa sa isang pares ng brace
(eg {kahapon}, {1 buwan 2 linggo 3 araw 1 oras 1 pangalawa nakaraan} or {1979-02-26
18:30:00}) ay tumutukoy sa halaga ng ref sa isang naunang punto ng oras. Ang suffix na ito ay maaaring
magagamit lamang kaagad kasunod ng isang pangalan ng ref at ang ref ay dapat na mayroong isang umiiral na log
($GIT_DIR/logs/). Tandaan na tinitingnan nito ang estado ng iyong lokal ref sa isang ibinigay
oras; hal, kung ano ang nasa iyong lokal panginoon sangay noong nakaraang linggo. Kung gusto mong tingnan
commit na ginawa sa ilang partikular na panahon, tingnan mo --dahil at --hanggang.

@{ }, halimbawa master@{1}
Isang ref na sinusundan ng suffix @ na may ordinal na detalye na nakapaloob sa isang pares ng brace
(eg 1 {}, 15 {}) ay tumutukoy sa n-th naunang halaga ng ref na iyon. Halimbawa master@{1}
ay ang agarang naunang halaga ng panginoon habang master@{5} ay ang ika-5 naunang halaga ng
panginoon. Ang suffix na ito ay maaari lamang gamitin kaagad pagkatapos ng isang ref name at ang ref ay dapat
may umiiral nang log ($GIT_DIR/logs/).

@{ }, halimbawa @{1}
Maaari mong gamitin ang @ bumuo gamit ang isang walang laman na bahagi ng ref upang makuha sa isang reflog entry ng
kasalukuyang sangay. Halimbawa, kung ikaw ay nasa sangay blabla pagkatapos @{1} pareho ang ibig sabihin ng
blabla@{1}.

@{- }, halimbawa @{-1}
Ang konstruksyon @{- } nangangahulugang ang na-check out ang th branch/commit bago ang kasalukuyang
isa.

@{upstream}, halimbawa master@{upstream}, @{u}
Ang suffix @{upstream} sa isang branchname (short form @{u}) tumutukoy sa
sangay kung saan ang sangay na tinukoy ng branchname ay nakatakdang buuin sa ibabaw ng (naka-configure
may sanga. .malayuan at sangay. .pagsamahin). Ang isang nawawalang branchname ay default sa
ang kasalukuyang.

@{push}, halimbawa master@{push}, @{push}
Ang suffix @{push} nag-uulat sa sangay na "kung saan kami magtutulak sa" kung ang git push ay tatakbo
habang ang branchname ay nasuri (o ang kasalukuyang HEAD kung walang tinukoy na pangalan ng sangay).
Dahil ang aming push destination ay nasa isang remote na imbakan, siyempre, iniuulat namin ang lokal
tracking branch na tumutugma sa branch na iyon (ibig sabihin, isang bagay sa refs/remote/).

Narito ang isang halimbawa upang gawin itong mas malinaw:

$ git config push.default kasalukuyang
$ git config remote.pushdefault myfork
$ git checkout -b mybranch pinanggalingan/master

$ git rev-parse --symbolic-full-name @{upstream}
refs/remote/origin/master

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

Tandaan sa halimbawa na nag-set up kami ng triangular na daloy ng trabaho, kung saan kami kumukuha mula sa isa
lokasyon at itulak sa isa pa. Sa isang di-triangular na daloy ng trabaho, @{push} ay pareho
@{upstream}, at hindi na kailangan para dito.

^, halimbawa ULO^, v1.5.1^0
Isang suffix ^ sa isang parameter ng rebisyon ay nangangahulugang ang unang magulang ng commit object na iyon. ^
nangangahulugang ang ika-magulang (hal ^ ay katumbas ng ^1). Bilang isang espesyal na tuntunin,
^0 ibig sabihin ang mismong commit at ginagamit kapag ay ang pangalan ng bagay ng isang tag
object na tumutukoy sa isang commit object.

~, halimbawa master~3
Isang suffix ~ sa isang parameter ng rebisyon ay nangangahulugan ng commit object na ang ika
henerasyong ninuno ng pinangalanang commit object, sumusunod lamang sa mga unang magulang. ibig sabihin
~3 ay katumbas ng ^^^ na katumbas ng ^1^1^1. Tingnan sa ibaba para sa isang
paglalarawan ng paggamit ng form na ito.

^{ }, halimbawa v0.99.8^{commit}
Isang suffix ^ na sinusundan ng isang pangalan ng uri ng bagay na nakapaloob sa pares ng brace ay nangangahulugan ng dereference
ang bagay sa recursively hanggang sa isang bagay ng uri ay matatagpuan o ang bagay
hindi na maaaring i-dereference (kung saan, barf). Halimbawa, kung ay isang
pangako, ^{commit} inilalarawan ang kaukulang commit object. Katulad nito, kung
ay isang puno, ^{puno} naglalarawan ng kaukulang punong bagay. ^0 is
isang maikling-kamay para sa ^{commit}.

rev^{object} maaaring gamitin para makasigurado rev pinangalanan ang isang bagay na umiiral, wala
nangangailangan rev upang maging isang tag, at walang dereferencing rev; dahil ang isang tag ay isa nang
object, hindi ito kailangang i-dereference kahit isang beses upang makarating sa isang bagay.

rev^{tag} maaaring gamitin upang matiyak na rev kinikilala ang isang umiiral na tag object.

^{}, halimbawa v0.99.8^{}
Isang suffix ^ na sinusundan ng isang walang laman na pares ng brace ay nangangahulugan na ang bagay ay maaaring isang tag, at
i-dereference ang tag nang paulit-ulit hanggang sa makita ang isang bagay na hindi tag.

^{/ }, halimbawa HEAD^{/ayos pangit bug}
Isang suffix ^ sa isang parameter ng rebisyon, na sinusundan ng isang pares ng brace na naglalaman ng text na humantong
sa pamamagitan ng isang slash, ay kapareho ng :/ayusin pangit kulisap syntax sa ibaba maliban na ibinabalik nito ang
pinakabatang matching commit na maaabot mula sa bago ^.

:/, halimbawa :/ayusin pangit kulisap
Ang isang tutuldok, na sinusundan ng isang slash, na sinusundan ng isang text, ay nagpapangalan sa isang commit na may commit na mensahe
tumutugma sa tinukoy na regular na expression. Ibinabalik ng pangalang ito ang pinakabatang tugma
commit na maaabot mula sa anumang ref. Kung ang commit message ay nagsisimula sa a ! ikaw
kailangang ulitin iyon; ang espesyal na pagkakasunod-sunod :/!, na sinusundan ng ibang bagay kaysa sa !, Ay
nakalaan sa ngayon. Maaaring tumugma ang regular na expression sa anumang bahagi ng commit message. Upang
tumugma sa mga mensahe na nagsisimula sa isang string, maaaring gamitin ng isa hal :/^foo.

:, halimbawa HEAD: BASAHIN MO, :README, master:./README
Isang suffix : na sinusundan ng isang path na pinangalanan ang blob o puno sa ibinigay na landas sa tree-ish
bagay na pinangalanan ng bahagi bago ang colon. : landas (na may isang walang laman na bahagi bago ang
colon) ay isang espesyal na kaso ng syntax na inilarawan sa susunod: nilalamang naitala sa index
sa ibinigay na landas. Isang landas na nagsisimula sa ./ or .. / ay may kaugnayan sa kasalukuyang pagtatrabaho
direktoryo. Ang ibinigay na landas ay iko-convert upang maging kaugnay sa ugat ng gumaganang puno
direktoryo. Ito ay pinakakapaki-pakinabang upang tugunan ang isang patak o puno mula sa isang commit o puno na
ay may parehong istraktura ng puno tulad ng gumaganang puno.

: :, halimbawa :0:README, :README
Isang tutuldok, opsyonal na sinusundan ng isang yugto ng numero (0 hanggang 3) at isang tutuldok, na sinusundan ng a
path, pinangalanan ang isang blob object sa index sa ibinigay na path. Isang nawawalang stage number (at
ang tutuldok na kasunod nito) ay nagpapangalan sa isang yugto 0 na entry. Sa panahon ng isang pagsasanib, ang yugto 1 ay ang
karaniwang ninuno, ang yugto 2 ay ang bersyon ng target na sangay (karaniwang ang kasalukuyang
branch), at ang stage 3 ay ang bersyon mula sa branch na pinagsasama.

Narito ang isang paglalarawan, ni Jon Loeliger. Parehong mga commit node B at C ay mga magulang ng commit
node A. Ang mga commit ng magulang ay iniutos kaliwa-pakanan.

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

PAGTUKOY PAGBABAGO

Ang kasaysayan na tumatawid sa mga utos tulad ng git log ay gumagana sa isang hanay ng mga commit, hindi lamang isang solong
mangako. Sa mga utos na ito, na tumutukoy sa isang rebisyon na may notasyong inilarawan sa
ang ibig sabihin ng nakaraang seksyon ay ang hanay ng mga commit na maaabot mula sa commit na iyon, kasunod ng commit
kadena ng mga ninuno.

Upang ibukod ang mga commit na maaabot mula sa isang commit, isang prefix ^ ginagamit ang notasyon. Hal ^r1 r2 paraan
commit maaabot mula sa r2 ngunit ibukod ang mga naaabot mula sa r1.

Ang hanay na operasyon na ito ay madalas na lumilitaw na mayroong isang shorthand para dito. Kapag mayroon kang dalawa
gumawa r1 at r2 (pinangalanan ayon sa syntax na ipinaliwanag sa PAGTUKOY NG MGA REVISION sa itaas),
maaari kang humingi ng mga commit na naaabot mula sa r2 hindi kasama ang mga naaabot mula sa
r1 ng ^r1 r2 at maaari itong isulat bilang r1..r2.

Isang katulad na notasyon r1...r2 ay tinatawag na simetriko pagkakaiba ng r1 at r2 at tinukoy bilang
r1 r2 --hindi $(git merge-base --lahat r1 r2). Ito ang hanay ng mga commit na maaabot
mula sa alinman sa r1 or r2 ngunit hindi mula sa dalawa.

Sa dalawang shorthand na ito, maaari mong alisin ang isang dulo at hayaan itong maging default sa HEAD. Halimbawa,
pinanggalingan.. ay isang shorthand para sa pinanggalingan.. ULO at nagtatanong ng "Ano ang ginawa ko mula nang maghiwalay ako mula sa
pinanggalingang sangay?" Katulad nito, ..pinanggalingan ay isang shorthand para sa ULO..pinagmulan at nagtatanong "Ano ang ginawa ng
pinanggalingan ko mula nang humiwalay ako sa kanila?" Pansinin iyon .. ibig sabihin ULO.. ULO na isang walang laman
range na parehong naaabot at hindi naaabot mula sa HEAD.

Dalawang iba pang mga shorthand para sa pagbibigay ng pangalan sa isang set na nabuo sa pamamagitan ng isang commit at ang magulang nito ay nag-commit
umiral. Ang r1^@ ang ibig sabihin ng notasyon ay lahat ng magulang ng r1. r1^! kasama ang commit r1 ngunit hindi kasama ang lahat
ng mga magulang nito.

Upang ibuod:


Isama ang mga commit na naaabot mula sa (ibig sabihin, mga ninuno ng) .

^
Ibukod ang mga commit na naaabot mula sa (ibig sabihin, mga ninuno ng) .

..
Isama ang mga commit na naaabot mula sa ngunit ibukod ang mga naaabot
mula sa . Kapag alinman o ay tinanggal, ito ay default sa HEAD.

...
Isama ang mga commit na maaabot mula sa alinman o ngunit ibukod ang mga iyon
ay maaabot mula sa pareho. Kapag alinman o ay tinanggal, ito ay default sa HEAD.

^@, halimbawa ULO^@
Isang suffix ^ na sinusundan ng isang at sign ay kapareho ng listahan ng lahat ng mga magulang ng
(ibig sabihin, isama ang anumang maaabot mula sa mga magulang nito, ngunit hindi ang mismong commit).

^!, halimbawa ULO^!
Isang suffix ^ na sinusundan ng tandang padamdam ay kapareho ng pagbibigay ng pangako at pagkatapos ay
lahat ng mga magulang nito ay may prefix na ^ upang ibukod sila (at ang kanilang mga ninuno).

Narito ang ilang mga halimbawa:

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

PARSEOPT

Sa --parseopt mode, pumunta rev-parse tumutulong sa mga pagpipilian sa masahe upang dalhin sa shell script ang
parehong mga pasilidad na mayroon ang C builtin. Gumagana ito bilang isang opsyon na normalizer (hal. splits single
nagpapalit ng mga pinagsama-samang halaga), medyo katulad getopt(1) ginagawa.

Ito ay tumatagal sa karaniwang input ang detalye ng mga opsyon para i-parse at maunawaan,
at umaalingawngaw sa karaniwang output ng isang string na angkop para sa sh(1) eval upang palitan ang
mga argumento na may mga na-normalize. Sa kaso ng error, naglalabas ito ng paggamit sa karaniwang error
stream, at lalabas na may code 129.

Tandaan: Siguraduhing i-quote mo ang resulta kapag ipinapasa ito sa eval. Tingnan sa ibaba para sa isang halimbawa.

input format
pumunta rev-parse --parseopt ang format ng pag-input ay ganap na nakabatay sa teksto. Ito ay may dalawang bahagi, na pinaghihiwalay ng
isang linya na naglalaman lamang ng --. Ang mga linya bago ang separator (dapat isa o higit pa) ay
ginagamit para sa paggamit. Ang mga linya pagkatapos ng separator ay naglalarawan ng mga opsyon.

Ang bawat linya ng mga opsyon ay may ganitong format:

* ? SP+ tulong LF


ang format nito ay ang maikling opsyon na karakter, pagkatapos ay ang mahabang pangalan ng opsyon na pinaghihiwalay ng a
kuwit. Ang parehong mga bahagi ay hindi kinakailangan, kahit na hindi bababa sa isa ay kinakailangan. Maaaring hindi maglaman
alinman sa mga mga karakter. h,help, dry-run at f ay mga halimbawa ng tama
.


ay ng *, =, ? o!.

· Gamitin = kung ang opsyon ay tumatagal ng argumento.

· Gamitin ? na nangangahulugan na ang opsyon ay tumatagal ng isang opsyonal na argumento. Malamang gusto mo
gamitin ang --stuck-long mode upang ma-parse nang malinaw ang opsyonal na argumento.

· Gamitin ang * upang sabihin na ang opsyong ito ay hindi dapat nakalista sa paggamit na nabuo para sa
-h argumento. Ito ay ipinapakita para sa --help-all bilang nakadokumento sa gitcliNa (7).

· Gamitin! upang hindi gawing available ang kaukulang negadong mahabang opsyon.


, kung tinukoy, ay ginagamit bilang isang pangalan ng argumento sa output ng tulong, para sa
mga opsyon na kumukuha ng mga argumento. ay winakasan ng unang whitespace. Ito ay
kaugalian na gumamit ng gitling upang paghiwalayin ang mga salita sa isang pahiwatig ng argumentong maraming salita.

Ang natitira sa linya, pagkatapos alisin ang mga puwang, ay ginagamit bilang tulong na nauugnay sa
ang pagpipilian.

Binabalewala ang mga blangkong linya, at ang mga linyang hindi tumutugma sa detalyeng ito ay ginagamit bilang opsyon
mga header ng pangkat (simulan ang linya na may puwang upang lumikha ng mga ganoong linya sa layunin).

halimbawa
OPTS_SPEC="\
some-command [mga opsyon] ...

some-command does foo and bar!
--
h, tumulong ipakita ang tulong

foo ilang magandang opsyon --foo
bar= ilang cool na opsyon --bar na may argumento
baz=arg isa pang cool na opsyon --baz na may pinangalanang argumento
qux?path qux ay maaaring kumuha ng path argument ngunit may kahulugan sa sarili

Isang header ng pangkat ng opsyon
C? opsyon C na may opsyonal na argumento"

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

Paggamit teksto
Kapag ang "$@" ay -h o --help sa halimbawa sa itaas, ang sumusunod na teksto ng paggamit ay ipapakita:

paggamit: some-command [mga opsyon] ...

some-command does foo and bar!

-h, --tulungan ipakita ang tulong
--foo ilang magandang opsyon --foo
--bar ... ilang cool na opsyon --bar na may argumento
--baz isa pang cool na opsyon --baz na may pinangalanang argumento
--qux[= Ang ] qux ay maaaring kumuha ng argumento ng landas ngunit may sarili itong kahulugan

Isang header ng pangkat ng opsyon
-C[...] opsyon C na may opsyonal na argumento

SQ-QUOTE

Sa --sq-quote mode, pumunta rev-parse umaalingawngaw sa karaniwang output ang isang linyang angkop para sa
sh(1) eval. Ang linyang ito ay ginawa sa pamamagitan ng pag-normalize ng mga argumentong sumusunod --sq-quote. Wala
maliban sa pagsipi ng mga argumento ay tapos na.

Kung gusto mong ang command input ay ma-interpret pa rin gaya ng dati ng pumunta rev-parse bago ang
ang output ay naka-quote sa shell, tingnan ang --sq na opsyon.

halimbawa
$ cat >your-git-script.sh <<\EOF
#!/ Bin / SH
args=$(git rev-parse --sq-quote "$@") # quote na mga argumentong ibinigay ng user
command="git frotz -n24 $args" # at gamitin ito sa loob ng isang gawang kamay
# command line
eval "$command"
EOF

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

HALIMBAWA

· I-print ang pangalan ng object ng kasalukuyang commit:

$ git rev-parse --verify HEAD

· I-print ang commit object name mula sa rebisyon sa $REV shell variable:

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

Magkaka-error ito kung ang $REV ay walang laman o hindi isang wastong rebisyon.

· Katulad sa itaas:

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

ngunit kung ang $REV ay walang laman, ang commit object name mula sa master ay ipi-print.

GIT

Parte ng pumunta(1) suite

Gumamit ng git-rev-parse online gamit ang mga serbisyo ng onworks.net