簡體中文 ▾ 主題 ▾ 最新版本 ▾ git-mktag 最後更新於 2.43.0

名稱

git-mktag - 建立帶有額外驗證的標籤物件

概要

git mktag

描述

從標準輸入讀取標籤的內容並建立一個標籤物件。輸出是新標籤的 <object> 識別符號。

此命令在很大程度上等同於使用 -t tag -w --stdin 呼叫 git-hash-object[1]。即,這兩者都將建立並寫入 my-tag 中的標籤

git mktag <my-tag
git hash-object -t tag -w --stdin <my-tag

區別在於,如果標籤未能透過 git-fsck[1] 檢查,mktag 將在寫入標籤之前退出。

mktag 執行的“fsck”檢查比 git-fsck[1] 預設執行的更嚴格,因為所有 fsck.<msg-id> 訊息都從警告提升為錯誤(因此,例如,缺少“tagger”行是一個錯誤)。

物件中的額外標題在 mktag 下也是一個錯誤,但會被 git-fsck[1] 忽略。可以透過設定相應的 fsck.<msg-id> 變數來關閉此額外檢查

git -c fsck.extraHeaderEntry=ignore mktag <my-tag-with-headers

選項

--strict

預設情況下,mktag 會啟用 git-fsck[1] --strict 模式的等效項。使用 --no-strict 停用它。

標籤格式

要饋送給此命令的標準輸入的標籤簽名檔案具有非常簡單的固定格式:四行

object <hash>
type <typename>
tag <tagname>
tagger <tagger>

後跟一些可選的自由格式訊息(由舊 Git 建立的一些標籤可能沒有 tagger 行)。訊息(如果存在)與標題之間用空行分隔。訊息部分可能包含 Git 本身不關心的簽名,但可以使用 gpg 進行驗證。

GIT

Git[1] 套件的一部分