git-commit-tree

原文： https://git-scm.com/docs/git-commit-tree

名称

git-commit-tree - 创建一个新的提交对象

概要

  1. git commit-tree <tree> [(-p <parent>)…​]
  2. git commit-tree [(-p <parent>)…​] [-S[<keyid>]] [(-m <message>)…​]
  3.           [(-F <file>)…​] <tree>

描述

这通常不是最终用户想要直接运行的。参见 git-commit [1] 。

基于提供的树对象创建新的提交对象，并在stdout上发出新的提交对象ID。除非给出-m或-F选项，否则将从标准输入读取日志消息。

提交对象可以包含任意数量的父项。只有一个父，它是一个普通的提交。拥有多个父级会使提交在多行历史记录之间合并。初始（root）提交没有父母。

虽然树表示工作目录的特定目录状态，但提交在“时间”中表示该状态，并说明如何到达那里。

通常一个提交会识别一个新的“HEAD”状态，而Git并不关心你在哪里保存关于该状态的注释，实际上我们倾向于只将结果写入.git/HEAD所指向的文件，所以我们总能看到最后承诺的状态是什么。

OPTIONS

  1.  <tree>

现有的树对象

  1.  -p <parent>

每个-p表示父提交对象的id。

  1.  -m <message>

提交日志消息中的段落。这可以被给予不止一次并且每个<消息>成为自己的段落。

  1.  -F <file>

从给定文件中读取提交日志消息。使用-从标准输入读取。

  1.  -S[<keyid>]
  1.  --gpg-sign[=<keyid>]

GPG签名提交。 keyid参数是可选的，默认为提交者标识;如果指定，它必须粘在没有空格的选项上。

  1.  --no-gpg-sign

不要GPG签名提交，以反击命令行先前给出的--gpg-sign选项。

提交信息

提交封装：

  • 所有父对象id

  • 作者姓名，电子邮件和日期

  • 提交者姓名和电子邮件以及提交时间。

在命令行上提供父对象ID时，作者和提交者信息取自以下环境变量，如果设置：

  1. GIT_AUTHOR_NAME
  2. GIT_AUTHOR_EMAIL
  3. GIT_AUTHOR_DATE
  4. GIT_COMMITTER_NAME
  5. GIT_COMMITTER_EMAIL
  6. GIT_COMMITTER_DATE

（nb“<”，“>”和“\ n”s被剥离）

如果未设置（某些）这些环境变量，则从配置项user.name和user.email获取信息，如果不存在，则获取环境变量EMAIL，或者，如果未设置，则系统用户用于发送邮件的名称和主机名（取自/etc/mailname并在该文件不存在时回退到完全限定的主机名）。

从stdin读取提交注释。如果未通过“<”提供更改日志条目重定向， git commit-tree 将等待一个输入并终止于^ D.

日期格式

GIT_AUTHOR_DATE，GIT_COMMITTER_DATE环境变量支持以下日期格式：

  1.  Git internal format

它是&lt;unix timestamp&gt; &lt;time zone offset&gt;，其中&lt;unix timestamp&gt;是自UNIX纪元以来的秒数。 &lt;time zone offset&gt;是UTC的正偏移或负偏移。例如，CET（比UTC早1小时）是+0100。

  1.  RFC 2822

RFC 2822描述的标准电子邮件格式，例如Thu, 07 Apr 2005 22:13:13 +0200。

  1.  ISO 8601

ISO 8601标准规定的时间和日期，例如2005-04-07T22:13:13。解析器也接受空格而不是T字符。

| 注意 | 此外，日期部分以下列格式接受：YYYY.MM.DD，MM/DD/YYYY和DD.MM.YYYY。 |

讨论

Git在某种程度上是字符编码不可知的。

  • blob对象的内容是未解释的字节序列。核心级别没有编码转换。

  • 路径名以UTF-8规范化形式C编码。这适用于树对象，索引文件，ref名称，以及命令行参数，环境变量和配置文件中的路径名（.git/config（参见 git） -config [1] ）， gitignore [5] ， gitattributes [5] 和 gitmodules [5] ）。

    请注意，核心级别的Git仅将路径名称视为非NUL字节序列，没有路径名称编码转换（Mac和Windows除外）。因此，即使在使用传统扩展ASCII编码的平台和文件系统上，使用非ASCII路径名也会起作用。但是，在此类系统上创建的存储库将无法在基于UTF-8的系统（例如Linux，Mac，Windows）上正常工作，反之亦然。此外，许多基于Git的工具只是假设路径名为UTF-8，并且无法正确显示其他编码。

  • 提交日志消息通常以UTF-8编码，但也支持其他扩展ASCII编码。这包括ISO-8859-x，CP125x和许多其他，但不是 UTF-16/32，EBCDIC和CJK多字节编码（GBK，Shift-JIS，Big5，EUC-x，CP9xx等。 ）。

虽然我们鼓励提交日志消息以UTF-8编码，但核心和Git瓷器都不是为了强制项目使用UTF-8。如果特定项目的所有参与者发现使用遗留编码更方便，Git不会禁止它。但是，有一些事情需要牢记。

  1. git commit 和 git commit-tree 发出警告，如果提供给它的提交日志消息看起来不像有效的UTF-8字符串，除非你明确说你的项目使用了遗产编码。说这个的方法是在.git/config文件中使用i18n.commitencoding，如下所示：

    1. [i18n]
    2.     commitEncoding = ISO-8859-1

    使用上述设置创建的提交对象在其encoding标题中记录i18n.commitEncoding的值。这是为了帮助其他人以后再看。缺少此标头意味着提交日志消息以UTF-8编码。

  2. git log ， git show ， git blame 和朋友们查看提交对象的encoding头，并尝试将日志消息重新编码为除非另有说明，否则为UTF-8。您可以使用.git/config文件中的i18n.logOutputEncoding指定所需的输出编码，如下所示：

    1. [i18n]
    2.     logOutputEncoding = ISO-8859-1

    如果您没有此配置变量，则使用i18n.commitEncoding的值。

请注意，我们故意选择在提交以在提交对象级别强制使用UTF-8时不重新编写提交日志消息，因为重新编码为UTF-8不一定是可逆操作。

FILES

在/ etc /邮件名

也可以看看

git-write-tree [1]

GIT

部分 git [1] 套件