Sync 02-git-basics recording-changes.

Author: sanddudu

book/02-git-basics/sections/recording-changes.asc

@@ -106,7 +106,9 @@ Changes not staged for commit:
 ----
 
 文件 `CONTRIBUTING.md` 出现在 `Changes not staged for commit` 这行下面，说明已跟踪文件的内容发生了变化，但还没有放到暂存区。
-要暂存这次更新，需要运行 `git add` 命令。这是个多功能命令：可以用它开始跟踪新文件，或者把已跟踪的文件放到暂存区，还能用于合并时把有冲突的文件标记为已解决状态等。将这个命令理解为“添加内容到下一次提交中”而不是“将一个文件添加到项目中”要更加合适。(((git commands, add)))
+要暂存这次更新，需要运行 `git add` 命令。
+这是个多功能命令：可以用它开始跟踪新文件，或者把已跟踪的文件放到暂存区，还能用于合并时把有冲突的文件标记为已解决状态等。
+将这个命令理解为“添加内容到下一次提交中”而不是“将一个文件添加到项目中”要更加合适。(((git commands, add)))
 现在让我们运行 `git add` 将"CONTRIBUTING.md"放到暂存区，然后再看看 `git status` 的输出：
 
 [source,console]
@@ -167,7 +169,9 @@ Changes to be committed:
 
 ==== 状态简览
 
-`git status` 命令的输出十分详细，但其用语有些繁琐。如果你使用 `git status -s` 命令或 `git status --short`        命令，你将得到一种更为紧凑的格式输出。运行 `git status -s` ，状态报告输出如下：
+`git status` 命令的输出十分详细，但其用语有些繁琐。
+如果你使用 `git status -s` 命令或 `git status --short` 命令，你将得到一种更为紧凑的格式输出。
+运行 `git status -s` ，状态报告输出如下：
 
 [source,console]
 ----
@@ -179,7 +183,10 @@ M  lib/simplegit.rb
 ?? LICENSE.txt
 ----
 
-新添加的未跟踪文件前面有 `??` 标记，新添加到暂存区中的文件前面有 `A` 标记。修改过的文件前面有 `M` 标记，你可能注意到了 `M` 有两个可以出现的位置，出现在右边的 `M` 表示该文件被修改了但是还没放入暂存区，出现在靠左边的 `M` 表示该文件被修改了并放入了暂存区。例如，上面的状态报告显示： `README` 文件在工作区被修改了但是还没有将修改后的文件放入暂存区,`lib/simplegit.rb` 文件被修改了并将修改后的文件放入了暂存区，而 `Rakefile` 在工作区被修改并提交到暂存区后又在工作区中被修改了，所以在暂存区和工作区都有该文件被修改了的记录。
+新添加的未跟踪文件前面有 `??` 标记，新添加到暂存区中的文件前面有 `A` 标记，修改过的文件前面有 `M` 标记。
+你可能注意到了 `M` 有两个可以出现的位置，出现在右边的 `M` 表示该文件被修改了但是还没放入暂存区，出现在靠左边的 `M` 表示该文件被修改了并放入了暂存区。
+例如，上面的状态报告显示： `README` 文件在工作区被修改了但是还没有将修改后的文件放入暂存区,`lib/simplegit.rb` 文件被修改了并将修改后的文件放入了暂存区。
+而 `Rakefile` 在工作区被修改并提交到暂存区后又在工作区中被修改了，所以在暂存区和工作区都有该文件被修改了的记录。
 
 [[_ignoring]]
 ==== 忽略文件
@@ -205,7 +212,8 @@ $ cat .gitignore
 
 *  所有空行或者以 `＃` 开头的行都会被 Git 忽略。
 *  可以使用标准的 glob 模式匹配。
-*  匹配模式以（`/`）结尾说明要忽略的是目录。
+*  匹配模式可以以（`/`）开头防止递归。
+*  匹配模式可以以（`/`）结尾指定目录。
 *  要忽略指定模式以外的文件或目录，可以在模式前加上惊叹号（`!`）取反。
 
 所谓的 glob 模式是指 shell 所使用的简化了的正则表达式。
@@ -222,7 +230,7 @@ $ cat .gitignore
 # but do track lib.a, even though you're ignoring .a files above
 !lib.a
 
-# only ignore the root TODO file, not subdir/TODO
+# only ignore the TODO file in the current directory, not subdir/TODO
 /TODO
 
 # ignore all files in the build/ directory
@@ -231,8 +239,8 @@ build/
 # ignore doc/notes.txt, but not doc/server/arch.txt
 doc/*.txt
 
-# ignore all .txt files in the doc/ directory
-doc/**/*.txt
+# ignore all .pdf files in the doc/ directory
+doc/**/*.pdf
 ----
 
 [TIP]
@@ -258,7 +266,7 @@ On branch master
 Changes to be committed:
   (use "git reset HEAD <file>..." to unstage)
 
-    new file:   README
+    modified:   README
 
 Changes not staged for commit:
   (use "git add <file>..." to update what will be committed)
@@ -281,7 +289,7 @@ index 8ebb991..643e24f 100644
  if we have to read the whole diff to figure out why you're contributing
  in the first place, you're less likely to get feedback and have your change
 -merged in.
-+merged in. Also, split your changes into comprehensive chunks if you patch is
++merged in. Also, split your changes into comprehensive chunks if your patch is
 +longer than a dozen lines.
  
  If you are starting to work on a particular area, feel free to submit a PR
@@ -308,12 +316,13 @@ index 0000000..03902a1
 请注意，git diff 本身只显示尚未暂存的改动，而不是自上次提交以来所做的所有改动。
 所以有时候你一下子暂存了所有更新过的文件后，运行 `git diff` 后却什么也没有，就是这个原因。
 
-像之前说的，暂存 `CONTRIBUTING.md` 后再编辑，运行 `git status` 会看到暂存前后的两个版本,如果我们的环境（终端输出）看起来如下：
+像之前说的，暂存 `CONTRIBUTING.md` 后再编辑，运行 `git status` 会看到暂存前后的两个版本。
+如果我们的环境（终端输出）看起来如下：
 
 [source,console]
 ----
 $ git add CONTRIBUTING.md
-$ echo 'test line' >> CONTRIBUTING.md
+$ echo '# test line' >> CONTRIBUTING.md
 $ git status
 On branch master
 Changes to be committed:
@@ -358,18 +367,19 @@ index 8ebb991..643e24f 100644
  if we have to read the whole diff to figure out why you're contributing
  in the first place, you're less likely to get feedback and have your change
 -merged in.
-+merged in. Also, split your changes into comprehensive chunks if you patch is
++merged in. Also, split your changes into comprehensive chunks if your patch is
 +longer than a dozen lines.
  
  If you are starting to work on a particular area, feel free to submit a PR
  that highlights your work in progress (and note in the PR title that it's
 ----
 
-[[_git_difftool]]
 [NOTE]
 .Git Diff 的插件版本
 ====
-在本书中，我们使用 `git diff` 来分析文件差异。但是，如果你喜欢通过图形化的方式或其它格式输出方式的话，可以使用 `git difftool` 命令来用 Araxis ，emerge 或 vimdiff 等软件输出 diff 分析结果。使用 `git difftool --tool-help` 命令来看你的系统支持哪些 Git Diff 插件。
+在本书中，我们使用 `git diff` 来分析文件差异。
+但是，如果你喜欢通过图形化的方式或其它格式输出方式的话，可以使用 `git difftool` 命令来用 Araxis ，emerge 或 vimdiff 等软件输出 diff 分析结果。
+使用 `git difftool --tool-help` 命令来看你的系统支持哪些 Git Diff 插件。
 ====
 
 [[_committing_changes]]