?
本文檔使用 php中文網手冊 發(fā)布
git-symbolic-ref - 讀取,修改和刪除符號引用
git symbolic-ref [-m <reason>] <name> <ref>git symbolic-ref [-q] [--short] <name>git symbolic-ref --delete [-q] <name>
給定一個參數,讀取哪個分支頭部給定的符號ref引用并輸出其相對于.git/
目錄的路徑。通常,您會HEAD
以<name>參數的形式提供您的工作樹所在的分支。
給定兩個參數,創(chuàng)建或更新符號ref <name>以指向給定分支<ref>。
給定--delete
和額外的參數,刪除給定的符號參考。
符號ref是一個常規(guī)文件,它存儲了一個以字符串開頭的字符串ref: refs/
。例如,你.git/HEAD
的內容是一個普通文件ref: refs/heads/master
。
-d --delete
刪除符號ref <名稱>。
-q --quiet
如果<name>不是符號引用,而是分離的HEAD,則不要發(fā)出錯誤消息; 而是靜靜地退出非零狀態(tài)。
--short
當示出了作為一個符號REF <名稱>的值,盡量縮短值,例如從refs/heads/master
到master
。
-m
使用<reason>更新<名稱>的reflog。這僅在創(chuàng)建或更新符號引用時有效。
過去,這.git/HEAD
是一個象征性的鏈接refs/heads/master
。當我們想切換到另一個分支時,我們做了ln -sf refs/heads/newbranch .git/HEAD
,當我們想知道我們在哪個分支時,我們做到了readlink .git/HEAD
。但符號鏈接不是完全可移植的,因此它們現(xiàn)在已被棄用,并且默認情況下使用符號引用(如上所述)。
如果符號ref的內容打印正確,git symbolic-ref
將以狀態(tài)0退出,如果請求的名稱不是符號參考,則為狀態(tài)1;如果發(fā)生另一錯誤,則為128。