• git-commit-tree
    • 名称
    • 概要
    • 描述
    • OPTIONS
    • 提交信息
    • 日期格式
    • 讨论
    • FILES
    • 也可以看看
    • GIT

    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] 套件