Review 02-git-basics viewing-history

Author: secondwtq

book/02-git-basics/sections/viewing-history.asc

@@ -4,15 +4,15 @@
 在提交了若干更新，又或者克隆了某个项目之后，你也许想回顾下提交历史。
 完成这个任务最简单而又有效的工具是 `git log` 命令。
 
-接下来的例子会用我专门用于演示的 simplegit 项目，
-运行下面的命令获取该项目源代码：
+我们使用一个非常简单的 ``simplegit'' 项目作为示例。
+运行下面的命令获取该项目：
 
 [source,console]
 ----
-git clone https://github.com/schacon/simplegit-progit
+$ git clone https://github.com/schacon/simplegit-progit
 ----
 
-然后在此项目中运行 git log，应该会看到下面的输出：(((git commands, log)))
+当你在此项目中运行 `git log` 命令时，可以看到下面的输出：(((git commands, log)))
 
 [source,console]
 ----
@@ -36,14 +36,14 @@ Date:   Sat Mar 15 10:31:28 2008 -0700
     first commit
 ----
 
-默认不用任何参数的话，`git log` 会按提交时间列出所有的更新，最近的更新排在最上面。
+不传入任何参数的默认情况下，`git log` 会按时间先后顺序列出所有的提交，最近的更新排在最上面。
 正如你所看到的，这个命令会列出每个提交的 SHA-1 校验和、作者的名字和电子邮件地址、提交时间以及提交说明。
 
 `git log` 有许多选项可以帮助你搜寻你所要找的提交，
-接下来我们介绍些最常用的。
+下面我们会介绍几个最常用的选项。
 
-一个常用的选项是 `-p`，用来显示每次提交的内容差异。
-你也可以加上 `-2` 来仅显示最近两次提交：
+其中一个比较有用的选项是 `-p`，它会显示每次提交所引入的差异。
+与此同时，你也可以使用 `-2` 选项来仅显示最近的两次提交：
 
 [source,console]
 ----
@@ -93,7 +93,7 @@ index a0a60ae..47c6340 100644
 该选项除了显示基本信息之外，还附带了每次 commit 的变化。
 当进行代码审查，或者快速浏览某个搭档提交的 commit 所带来的变化的时候，这个参数就非常有用了。
 你也可以为 `git log` 附带一系列的总结性选项。
-比如说，如果你想看到每次提交的简略的统计信息，你可以使用 `--stat` 选项：
+比如你想看到每次提交的简略统计信息，可以使用 `--stat` 选项：
 
 [source,console]
 ----
@@ -131,11 +131,11 @@ Date:   Sat Mar 15 10:31:28 2008 -0700
 正如你所看到的，`--stat` 选项在每次提交的下面列出所有被修改过的文件、有多少文件被修改了以及被修改过的文件的哪些行被移除或是添加了。
 在每次提交的最后还有一个总结。
 
-另外一个常用的选项是 `--pretty`。
-这个选项可以指定使用不同于默认格式的方式展示提交历史。
+另一个非常有用的选项是 `--pretty`。
+这个选项可以使用不同于默认格式的方式展示提交历史。
 这个选项有一些内建的子选项供你使用。
-比如用 `oneline` 将每个提交放在一行显示，查看的提交数很大时非常有用。
-另外还有 `short`，`full` 和 `fuller` 可以用，展示的信息或多或少有些不同，请自己动手实践一下看看效果如何。
+比如 `oneline` 会将每个提交放在一行显示，在浏览大量的提交时非常有用。
+另外还有 `short`，`full` 和 `fuller` 选项，它们展示信息的格式基本一致，但是详尽程度不一：
 
 [source,console]
 ----
@@ -163,20 +163,20 @@ a11bef0 - Scott Chacon, 6 years ago : first commit
 [cols="1,4",options="header"]
 |================================
 | 选项   | 说明
-| `%H`     | 提交对象（commit）的完整哈希字串
-| `%h`     | 提交对象的简短哈希字串
-| `%T`     | 树对象（tree）的完整哈希字串
-| `%t`     | 树对象的简短哈希字串
-| `%P`     | 父对象（parent）的完整哈希字串
-| `%p`     | 父对象的简短哈希字串
-| `%an`    | 作者（author）的名字
+| `%H`     | 提交的完整哈希值
+| `%h`     | 提交的简写哈希值
+| `%T`     | 树的完整哈希值
+| `%t`     | 树的简写哈希值
+| `%P`     | 父提交的完整哈希值
+| `%p`     | 父提交的简写哈希值
+| `%an`    | 作者名字
 | `%ae`    | 作者的电子邮件地址
 | `%ad`    | 作者修订日期（可以用 --date= 选项定制格式）
 | `%ar`    | 作者修订日期，按多久以前的方式显示
 | `%cn`    | 提交者（committer）的名字
 | `%ce`    | 提交者的电子邮件地址
 | `%cd`    | 提交日期
-| `%cr`    | 提交日期，按多久以前的方式显示
+| `%cr`    | 提交日期（相对）
 | `%s`     | 提交说明
 |================================
 
@@ -213,40 +213,40 @@ $ git log --pretty=format:"%h %s" --graph
 [cols="1,4",options="header"]
 |================================
 | 选项            | 说明
-| `-p`              | 按补丁格式显示每个更新之间的差异。
-| `--stat`          | 显示每次更新的文件修改统计信息。
+| `-p`              | 按补丁格式显示每个提交引入的差异。
+| `--stat`          | 显示每次提交的文件修改统计信息。
 | `--shortstat`     | 只显示 --stat 中最后的行数修改添加移除统计。
 | `--name-only`     | 仅在提交信息后显示已修改的文件清单。
 | `--name-status`   | 显示新增、修改、删除的文件清单。
-| `--abbrev-commit` | 仅显示 SHA-1 的前几个字符，而非所有的 40 个字符。
-| `--relative-date` | 使用较短的相对时间显示（比如，“2 weeks ago”）。
-| `--graph`         | 显示 ASCII 图形表示的分支合并历史。
-| `--pretty`        | 使用其他格式显示历史提交信息。可用的选项包括 oneline，short，full，fuller 和 format（后跟指定格式）。
+| `--abbrev-commit` | 仅显示 SHA-1 校验和所有 40 个字符中的前几个字符。
+| `--relative-date` | 使用较短的相对时间而不是完整格式显示日期（比如，``2 weeks ago''）。
+| `--graph`         | 在日志旁以 ASCII 图形显示分支与合并历史。
+| `--pretty`        | 使用其他格式显示历史提交信息。可用的选项包括 oneline，short，full，fuller 和 format（用来定义自己的格式）。
 |================================
 
 ==== 限制输出长度
 
-除了定制输出格式的选项之外，`git log` 还有许多非常实用的限制输出长度的选项，也就是只输出部分提交信息。
-之前你已经看到过 `-2` 了，它只显示最近的两条提交，
-实际上，这是 `-<n>` 选项的写法，其中的 `n` 可以是任何整数，表示仅显示最近的若干条提交。
-不过实践中我们是不太用这个选项的，Git 在输出所有提交时会自动调用分页程序，所以你一次只会看到一页的内容。
+除了定制输出格式的选项之外，`git log` 还有许多非常实用的限制输出长度的选项，也就是只输出一部分的提交。
+之前你已经看到过 `-2` 选项了，它只会显示最近的两条提交，
+实际上，你可以使用类似 `-<n>` 的选项，其中的 `n` 可以是任何整数，表示仅显示最近的 `n` 条提交。
+不过实践中这个选项不是很常用，因为 Git 默认会将所有的输出传送到分页程序中，所以你一次只会看到一页的内容。
 
-另外还有按照时间作限制的选项，比如 `--since` 和 `--until` 也很有用。
-例如，下面的命令列出所有最近两周内的提交：
+但是，类似 `--since` 和 `--until` 这种按照时间作限制的选项很有用。
+例如，下面的命令会列出最近两周的所有提交：
 
 [source,console]
 ----
 $ git log --since=2.weeks
 ----
 
-这个命令可以在多种格式下工作，比如说具体的某一天 `"2008-01-15"`，或者是相对地多久以前 `"2 years 1 day 3 minutes ago"`。
+该命令可用的格式十分丰富——可以是类似 `"2008-01-15"` 的具体的某一天，也可以是类似 `"2 years 1 day 3 minutes ago"` 的相对日期。
 
-还可以给出若干搜索条件，列出符合的提交。
+还可以过滤出匹配指定条件的提交。
 用 `--author` 选项显示指定作者的提交，用 `--grep` 选项搜索提交说明中的关键字。
-（请注意，如果要得到同时满足这两个选项搜索条件的提交，就必须用 `--all-match` 选项。否则，满足任意一个条件的提交都会被匹配出来）
+（请注意，如果你要同时对作者和提交说明进行过滤，就必须添加 `--all-match` 选项，否则该命令将会匹配满足其中任意一个条件的提交）
 
-另一个非常有用的筛选选项是 `-S`，可以列出那些添加或移除了某些字符串的提交。
-比如说，你想找出添加或移除了某一个特定函数的引用的提交，你可以这样使用：
+另一个非常有用的过滤器是 `-S`，它接受一个字符串参数，并且只会显示那些添加或删除了该字符串的提交。
+假设你想找出添加或删除了对某一个特定函数的引用的提交，可以调用：
 
 [source,console]
 ----
@@ -267,13 +267,13 @@ $ git log -Sfunction_name
 | `-(n)`                | 仅显示最近的 n 条提交
 | `--since`, `--after`  | 仅显示指定时间之后的提交。
 | `--until`, `--before` | 仅显示指定时间之前的提交。
-| `--author`            | 仅显示指定作者相关的提交。
-| `--committer`         | 仅显示指定提交者相关的提交。
-| `--grep`              | 仅显示含指定关键字的提交
-| `-S`                  | 仅显示添加或移除了某个关键字的提交
+| `--author`            | 仅显示作者匹配指定字符串的提交。
+| `--committer`         | 仅显示提交者匹配指定字符串的提交。
+| `--grep`              | 仅显示提交说明中包含指定字符串的提交
+| `-S`                  | 仅显示添加或删除内容匹配指定字符串的提交
 |================================
 
-来看一个实际的例子，如果要查看 Git 仓库中，2008 年 10 月期间，Junio Hamano 提交的但未合并的测试文件，可以用下面的查询命令：(((log filtering)))
+来看一个实际的例子，如果要查看 2008 年 10 月期间 Git 源代码仓库中，由 Junio Hamano 提交的修改了测试文件并且尚未合并的提交，可以使用下面的命令:(((log filtering)))
 
 [source,console]
 ----