これは、Ubuntu Online、Fedora Online、Windows オンライン エミュレーター、または MAC OS オンライン エミュレーターなどの複数の無料オンライン ワークステーションの XNUMX つを使用して、OnWorks 無料ホスティング プロバイダーで実行できるコマンド git-describe です。
プログラム:
NAME
git-describe - 到達可能な最新のタグを使用してコミットを説明します
SYNOPSIS
git 説明する [--すべて] [--タグ] [--含む] [--abbrev= ][ ...]
git 説明する [--すべて] [--タグ] [--含む] [--abbrev= ] --汚れ[= ]
DESCRIPTION
このコマンドは、コミットから到達可能な最新のタグを検索します。 タグがポイントの場合
コミットまでは、タグのみが表示されます。 それ以外の場合は、タグ名の末尾に
タグ付けされたオブジェクトに対する追加コミットの数とオブジェクトの短縮名
最新のコミットの。
デフォルト (--all または --tags なし) では、git description では注釈付きのタグのみが表示されます。 多くのための
注釈付きタグの作成については、-a および -s オプションを参照してください。 git タグとします。
OPTIONS
...
コミット風のオブジェクト名を説明します。 省略した場合のデフォルトは HEAD です。
--汚れ[= ]
作業ツリーについて説明します。 HEADを記述して追加することを意味します(-汚れた
デフォルト)作業ツリーがダーティな場合。
- すべて
注釈付きタグのみを使用する代わりに、refs/ 名前空間にある任意の ref を使用します。 これ
このオプションを使用すると、既知のブランチ、リモート追跡ブランチ、または軽量タグの照合が可能になります。
-タグ
注釈付きタグのみを使用する代わりに、refs/tags 名前空間にある任意のタグを使用します。
このオプションにより、軽量 (アノテーションなし) タグの照合が有効になります。
--含む
コミットよりも前のタグを見つけるのではなく、コミットの後に来るタグを見つけます。
commit するので、それが含まれます。 自動的に --tags が暗黙的に指定されます。
--abbrev=
デフォルトの 7 桁の XNUMX 進数をオブジェクトの短縮名として使用する代わりに、
数字、または一意のオブジェクト名を形成するために必要な数の数字。 アン意志0の
長い形式を抑制し、最も近いタグのみを表示します。
--候補者=
最新の 10 個のタグだけを候補として考慮するのではなく、
入力コミットっぽい最大までを考慮候補者たち。 増加中10以上かかります
わずかに長くなりますが、より正確な結果が得られる可能性があります。 アン0 の場合のみ発生します
完全一致が出力されます。
- 完全に一致
完全一致のみを出力します (タグは指定されたコミットを直接参照します)。 これは
--candidates=0 の同義語。
- デバッグ
標準で採用されている検索戦略に関する情報を詳細に表示します。
エラー。 タグ名は標準出力に出力されます。
- 長さ
常に長い形式 (タグ、コミット数、短縮形) を出力します。
コミット名) がタグに一致する場合でも。 部分的に見たいときに便利です。
問題のコミットが発生した場合でも、「describe」出力内のコミット オブジェクト名
タグ付きバージョンになります。 単にタグ名を発行するのではなく、そのようなタグを記述します。
v1.2-0-gdeadbee としてコミット (オブジェクトを指すタグ v0 以降、1.2 番目のコミット)
デッドビー....)。
- マッチ
指定されたものに一致するタグのみを考慮します 地球(7) 「refs/tags/」を除くパターン
接頭辞。 これは、リポジトリからのプライベート タグの漏洩を避けるために使用できます。
- いつも
一意に省略されたコミット オブジェクトをフォールバックとして表示します。
--最初の親
マージ コミットを確認したら、最初の親コミットのみをたどります。 こんなときに便利です
ターゲットコミットの履歴にマージされたブランチのタグと一致しないようにしたい場合。
例
git.git の現在のツリーのようなものを使用すると、次のようになります。
[torvalds@g5 git]$ git は親を説明します
v1.0.4-14-g2414721
つまり、私の「親」ブランチの現在のヘッドは v1.0.4 に基づいていますが、いくつかのバージョンがあるため、
これに加えて、describe は追加のコミット数 (「14」) を追加し、
最後にコミット自体の省略されたオブジェクト名 (「2414721」)。
追加のコミットの数は、「git」によって表示されるコミットの数です。
log v1.0.4..parent"。ハッシュサフィックスは、"-g" + 7 文字のチップコミットの省略形です。
親 (2414721b194453f058079d897d13c4e377f92dc6)。 接頭辞「g」は、
「git」は、SCM に応じてソフトウェアのバージョンを記述できるようにするために使用されます。
ソフトウェアで管理されています。 これは、人々が異なるものを使用する可能性がある環境で役立ちます。
SCM。
やること git 説明する タグ名ではタグ名のみが表示されます。
[torvalds@g5 git]$ git 説明 v1.0.4
v1.0.4
--all を使用すると、コマンドはブランチ ヘッドを参照として使用できるため、出力には
参照パスも同様に:
[torvalds@g5 git]$ git description --all --abbrev=4 v1.0.5^2
タグ/v1.0.0-21-g975b
[torvalds@g5 git]$ git description --all --abbrev=4 HEAD^
heads/lt/describe-7-g975b
--abbrev を 0 に設定すると、このコマンドを使用して、何も指定せずに最も近いタグ名を検索できます。
サフィックス:
[torvalds@g5 git]$ git description --abbrev=0 v1.0.5^2
タグ/v1.0.0
これらのコマンドを今日入力した場合に取得されるサフィックスは、実際のサフィックスよりも長くなる可能性があることに注意してください。
Git リポジトリに新しいコミットがある可能性があるため、Linus がこれらのコマンドを実行したときに上記を確認しました。
オブジェクト名が当時は存在しなかった 975b で始まり、接尾辞が「-g975b」だけになっている
これらのコミットを明確にするのに十分ではない可能性があります。
検索 戦略
提供されたコミットごとに、 git 説明する まず、正確にタグ付けされているタグを探します
そのコミット。 注釈付きタグは常に軽量タグよりも優先されます。
新しい日付は、古い日付のタグよりも常に優先されます。 完全一致の場合
見つかった場合は、その名前が出力され、検索が停止されます。
完全に一致するものが見つからなかった場合は、 git 説明する コミット履歴をたどります
タグ付けされた祖先コミットを見つけます。 祖先のタグが出力されます
入力 commit-ish の SHA-1 の省略形を使用します。 もしも --最初の親 その時指定された
ウォークでは、各コミットの最初の親のみが考慮されます。
ウォーク中に複数のタグが見つかった場合は、コミットが最も少ないタグが選択されます。
入力と異なるコミットっぽいものを選択して出力します。 ここでコミットが最も少ない
異なる値は、git log tag..input によって表示されるコミットの数として定義されます。
可能な最小のコミット数になります。
GIT
の一部 git(1)スイート
onworks.net サービスを使用してオンラインで git-describe を使用する