git-describe - 云端在线

程序：

您的姓名

git-describe - 使用可从中获取的最新标签来描述提交

概要

混帐 描述 [--all] [--tags] [--contains] [--abbrev= ] [ ...]
混帐 描述 [--all] [--tags] [--contains] [--abbrev= ] --脏[= ]

商品描述

该命令查找可从提交中访问的最新标记。 如果标签指向
到提交，然后只显示标签。 否则，它会在标签名称后加上
在标记对象和缩写对象名称之上的附加提交数
最近提交的。

默认情况下（没有 --all 或 --tags） git describe 只显示带注释的标签。 更多
有关创建带注释的标签的信息，请参阅 -a 和 -s 选项 git标签（1）。

配置

...
用于描述的提交对象名称。 如果省略，则默认为 HEAD。

--脏[= ]
描述工作树。 这意味着描述 HEAD 并附加(-脏了
默认）如果工作树是脏的。

- 全部
不要只使用带注释的标签，而是使用在 refs/ 命名空间中找到的任何 ref。 这个
选项启用匹配任何已知分支、远程跟踪分支或轻量级标签。

--标签
不要只使用带注释的标签，而是使用在 refs/tags 命名空间中找到的任何标签。
此选项启用匹配轻量级（非注释）标签。

--包含
与其查找提交之前的标签，不如查找提交之后的标签
提交，因此包含它。 自动暗示 --tags。

--缩写=
不要使用默认的 7 个十六进制数字作为缩写的对象名称，而是使用
数字，或形成唯一对象名称所需的任意数量的数字。 一个的 0 将
禁止长格式，只显示最近的标签。

--候选人=
而不是只考虑 10 个最近的标签作为候选来描述
输入 commit-ish 考虑最多候选人。 增加超过 10 将需要
稍长，但可能会产生更准确的结果。 一个0 只会导致
要输出的精确匹配。

- 完全符合
仅输出完全匹配（标签直接引用提供的提交）。 这是一个
--candidates=0 的同义词。

-调试
详细显示有关用于标准的搜索策略的信息
错误。 标签名称仍将打印为标准输出。

- 长
始终输出长格式（标签、提交次数和缩写
提交名称），即使它与标签匹配。 当您想查看部分内容时，这很有用
“描述”输出中的提交对象名称，即使有问题的提交发生
成为标记版本。 它不只是发出标签名称，而是描述这样一个
提交为 v1.2-0-gdeadbee（自指向对象的标记 v0 以来的第 1.2 次提交
死蜂……）。

- 比赛
只考虑匹配给定的标签 水珠(7) 模式，不包括“refs/tags/”
字首。 这可用于避免从存储库中泄露私有标签。

- 总是
将唯一缩写的提交对象显示为后备。

--第一父母
看到合并提交后，只关注第一个父提交。 这在以下情况下很有用
您不希望匹配目标提交历史记录中合并的分支上的标签。

示例

使用 git.git current tree 之类的东西，我得到：

[torvalds@g5 git]$ git 描述父级
v1.0.4-14 - g2414721

即我的“父”分支的当前负责人基于 v1.0.4，但由于它有一些
最重要的是提交，describe 已经添加了额外提交的数量（“14”）和一个
最后是提交本身的缩写对象名称（“2414721”）。

额外提交的数量是“git”将显示的提交数量
log v1.0.4..parent”。哈希后缀是“-g”+ 7-char 缩写，用于提示提交
父（为 2414721b194453f058079d897d13c4e377f92dc6）。 “g”前缀代表
“git”，用于根据 SCM 描述软件版本
软件管理。 这在人们可能使用不同的环境中很有用
单片机。

做一个 混帐 描述 在标签名称上只会显示标签名称：

[torvalds@g5 git]$ git 描述 v1.0.4
v1.0.4

使用 --all，该命令可以使用分支头作为引用，因此输出显示
参考路径也是：

[torvalds@g5 git]$ git 描述 --all --abbrev=4 v1.0.5^2
标签/v1.0.0-21-g975b

[torvalds@g5 git]$ git 描述 --all --abbrev=4 HEAD ^
头/lt/describe-7-g975b

将 --abbrev 设置为 0，该命令可用于查找最接近的标记名，而无需任何标记名
后缀：

[torvalds@g5 git]$ git 描述 --abbrev=0 v1.0.5^2
标签/v1.0.0

请注意，如果您今天键入这些命令，您得到的后缀可能比
Linus 在运行这些命令时看到了上面的内容，因为您的 Git 存储库可能有新的提交
其对象名称以当时不存在的 975b 开头，并且只有“-g975b”后缀
可能不足以消除这些提交的歧义。

搜索 策略

对于提供的每个 commit-ish， 混帐 描述 将首先查找准确标记的标签
那个提交。 带注释的标签总是优先于轻量级标签，并且带有
较新的日期总是优先于较旧日期的标签。 如果完全匹配
找到后，将输出其名称并停止搜索。

如果没有找到完全匹配， 混帐 描述 将遍历提交历史到
找到一个被标记的祖先提交。 祖先的标签将沿输出
带有输入 commit-ish 的 SHA-1 的缩写。 如果 --第一父母 当时被指定
walk 只会考虑每个提交的第一个父项。

如果在遍历过程中发现多个标签，则提交最少的标签
不同于输入的 commit-ish 将被选中并输出。 这里最少的提交
不同被定义为将通过 git log tag..input 显示的提交数量
将是尽可能少的提交。

GIT

部分 混帐(1) 套房

使用 onworks.net 服务在线使用 git-describe