|
Size: 6245
Comment:
|
Size: 6253
Comment: 把"动词"改成"--v"
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| #language zh |
|
| Line 3: | Line 5: |
| 现在我们已经参照 ChineseTutorialClone 克隆了一个 [:Repository:仓库]; 我们本地拷贝叫 {{{my-hello}}}. | 现在我们已经参照 [:ChineseTutorialClone:教程 - 克隆仓库] 克隆了一个 [:Repository:仓库]; 我们仓库的本地拷贝叫 {{{my-hello}}}. |
| Line 5: | Line 7: |
| Let's take a look at the history of this repository. To do this, we use the {{{log}}} command. This prints a summary of every event that has occurred in the [:Repository:仓库], going backwards in time from the most recent. | 让我们看一看这个仓库的历史记录。我们用 {{{log}}} 命令来做这个事情。这个命令按时间顺序从近到远输出在[:Repository:仓库]中发生的每一个事件。 |
| Line 22: | Line 24: |
| These lines of output bear some describing. | 这些输出行的含义是这样的。 |
| Line 24: | Line 26: |
| * Each paragraph describes a particular ChangeSet. A ChangeSet is a modification of one or more files, grouped together into a logical unit. * In our case above, we can see that the [Repository:仓库]'s history consists of two ["ChangeSet"]s. * {{{changeset}}} identifies a ChangeSet. * The first number before the colon is a RevisionNumber; it is a local short-hand way of identifying the ChangeSet. It is only valid within this ["Repository"]. * The long hexadecimal string after the colon is a ChangeSetID; it uniquely identifies the ChangeSet, and is the same in all repositories that contain this ChangeSet. If you are ever discussing a ChangeSet with someone else, use the ChangeSetID, not the RevisionNumber. * {{{tag}}} is a ["Tag"], an arbitrary symbolic name for a ChangeSet. * You can assign one or more ["Tag"]s to any ChangeSet. Actually, not that many ["ChangeSet"]s will have ["Tag"]s associated with them, so the {{{tag}}} line will seldom be present. * The special ["Tag"] named {{{tip}}} always identifies the ["Tip"], which is the most recent ChangeSet in the ["Repository"]. If you create another ChangeSet (and we will, soon), that will become the ["Tip"]. * {{{user}}} identifies the person who created the ChangeSet. This is a free-form string; it usually contains an email address, and sometimes a person's name, too. * {{{date}}} describes when the ChangeSet was created. These dates are printed in the local time zone the creator of the ChangeSet was in. * {{{summary}}} gives the first line of the description of the ChangeSet. This was entered by the creator of the ChangeSet at the time they created it, to help themselves and others understand the purpose of the ChangeSet. * {{{parent}}} identifies the parent ["ChangeSet"]s, in case there are more than one, which happens when you merge changes from several repositories. * Most of the times there is only one parent, which is the one changeset older than itself. This is the case in our example above. |
* 每一段描述一个特定的改变集。一个或几个文件的改变集合在一起形成一个逻辑单元，称为改变集。 * 在上面的例子中，我们可以看到该[:Repository:仓库] 的历史包括了两个[:"ChangeSet":改变集]。 * {{{changeset}}} 标识了一个 [:"ChangeSet":改变集]. * 冒号前面的数字代表版本号; 它是一种标识[:"ChangeSet":改变集]的本地缩写.只是在你的本地[:Repository:仓库]中这个版本号才有意义. * 冒号后面的那个很长的十六进制串是 ChangeSetID; 它是标识[:"ChangeSet":改变集]的全局唯一标识符, 在所有包含这个[:"ChangeSet":改变集]的[:Repository:仓库]中都相同. 如果你正在和其他人讨论某个改变集,请使用这个 ChangeSetID,而不是上面说的版本号. * {{{tag}}} 是一个[:"Tag":标签],可以理解成为一个改变集指定的名字. * 你可以给任何改变集指定一个或者多个[:"Tag":标签]. 实际上, 许多[:"ChangeSet":改变集]都是没有[:"Tag":标签]的, 所以{{{tag}}}这一行很多时候都不存在. * 名叫{{{tip}}} 的特殊[:"Tag":标签]总是表示，它是[:Repository:仓库]中最后一个[:"ChangeSet":改变集]。 如果你创建另外的[:"ChangeSet":改变集]（一会我们会看到），那么它将会变成 ["Tip"]。 * {{{user}}} 确定了谁创建了本[:"ChangeSet":改变集]。这是一个无格式的字符串; 它通常包括电子邮件地址，个人姓名等。 * {{{date}}} 描述了[:"ChangeSet":改变集]是什么时候创建的。这些时间是创建[:"ChangeSet":改变集]的人所在区域的当地时间。 * {{{summary}}} 给出了[:"ChangeSet":改变集]描述的首行。它是在创建[:"ChangeSet":改变集]时进入的，它可以帮助创建者和其它人了解[:"ChangeSet":改变集]的目的。 * {{{parent}}} 标志了[:"ChangeSet":改变集]的父辈，当你从几个仓库合并而来的情况下，父辈有多个。 * 大多数情况只有一个父辈，它比目前的改变集旧。这是在我们例子中使用的。 |
| Line 38: | Line 40: |
| We can get more detailed history information by asking for verbose output with the {{{-v}}} option, or the {{{--debug}}} global option for everything under the sun: | 我们可以通过指定{{{-v}}}诊断输出选项来获得更多更详细的历史信息, 或者指定{{{--debug}}}选项来获得历史信息中的一切细节: |
| Line 67: | Line 69: |
| Verbose output contains a few more fields than the default output. | --v的输出比缺省输出要多。 |
| Line 69: | Line 71: |
| * {{{changeset}}} now gives the unabbreviated ChangeSetID. * {{{files}}} lists the files modified in this ChangeSet. * {{{description}}} contains the complete multi-line description of the ChangeSet, rather than just the first line. * In our case, the descriptions are only one-line long, so there's not much difference. |
* {{{changeset}}} 给出不缩略的[:ChangSetID:改变集标号]。 * {{{files}}} 列出在本[:"ChangeSet":改变集]中文件的改变。 * {{{description}}} 包含了[:"ChangeSet":改变集]的完整多行描述而不仅是头一行。 * 在我们例子中，描述都只有一行，所以没什么特别不同的地方。 |
| Line 75: | Line 77: |
| The --debug output adds the following fields to the verbose output: | --debug 给谓词输出添加了以下方面： |
| Line 77: | Line 79: |
| * {{{file+}}} lists the file added in this changeset. * {{{file-}}} lists the file removed in this changeset. * {{{manifest}}} gives the ["Manifest"] ID for this changeset. * two {{{parent}}} fields giving the changeset ID of both parents for this changeset, where {{{-1:0000000000000000000000000000000000000000}}} refers to a non-existant parent. |
* {{{file+}}} 列出了在此改变集中增加的文件。 * {{{file-}}} 列出了在此改变集中删除的文件。 * {{{manifest}}} 给这个改变集一个 ["Manifest"] 号。 * 两个 {{{parent}}} 域给这个改变集的两个父辈号码， {{{-1:0000000000000000000000000000000000000000}}} 表示没有父改变集。 |
| Line 83: | Line 85: |
| The {{{log}}} command comes with a {{{-r}}} option to view specific changesets. | {{{log}}} 命令与 {{{-r}}} 选项一起使用可以查看特定改变集。 |
| Line 94: | Line 97: |
| <!> The {{{-r}}} option actually supports a very flexible syntax to select range of changesets. However, due to limited number of changesets available in our sample repository, we are unable to provide a good demonstration. Please consult Mercurial's [http://www.selenic.com/mercurial/hg.1.html manpage] for more information. | <!> The {{{-r}}} 选项实际上支持一种非常灵活的语法来选择改变集的范围。但是由于在我们例子的仓库里的改变集很有限，我们不能做很好的示范。你可以看 Mercurial 的 [http://www.selenic.com/mercurial/hg.1.html manpage] 来得到更多的信息。 |
| Line 96: | Line 99: |
| The {{{log}}} command also comes with a {{{-p}}} option to show the patches associated with the changesets: | {{{log}}} 命令与 {{{-p}}} 选项一起可以显示和此改变集相关联的补丁。 |
| Line 114: | Line 117: |
| We can also use the {{{tip}}} command to show info of the ''tip'', i.e. the latest, changeset. The {{{tip}}} command may be considered a shortcut to {{{log -r tip}}}, except that it does not support the {{{-p}}} option. | 我们也可以使用 {{{tip}}} 命令来显示 ''tip'' 的信息，如最后的改变集。 {{{tip}}} 命令除了不支持 {{{-p}}} 选项外，它可以当做 {{{log -r tip}}} 的快捷方式， |
| Line 133: | Line 136: |
| Now that we have some slight idea of what has happened, let's jump in and make some changes! Onwards, to TutorialFirstChange! | 现在我们对发生了什么有了一点概念，现在让我们进入并做一些修改吧！进入 [:ChineseTutorialFirstChange:教程 - 生成第一个[变更]]! ---- CategoryChinese |
教程 - 检查仓库历史
现在我们已经参照 [:ChineseTutorialClone:教程 - 克隆仓库] 克隆了一个 [:Repository:仓库]; 我们仓库的本地拷贝叫 my-hello.
让我们看一看这个仓库的历史记录。我们用 log 命令来做这个事情。这个命令按时间顺序从近到远输出在[:Repository:仓库]中发生的每一个事件。
$ cd my-hello $ hg log changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile changeset: 0:0a04b987be5a user: mpm@selenic.com date: Fri Aug 26 01:20:50 2005 -0700 summary: Create a standard "hello, world" program
这些输出行的含义是这样的。
- 每一段描述一个特定的改变集。一个或几个文件的改变集合在一起形成一个逻辑单元，称为改变集。
在上面的例子中，我们可以看到该[:Repository:仓库] 的历史包括了两个[:"ChangeSet":改变集]。
changeset 标识了一个 [:"ChangeSet":改变集].
tag 是一个[:"Tag":标签],可以理解成为一个改变集指定的名字.
user 确定了谁创建了本[:"ChangeSet":改变集]。这是一个无格式的字符串; 它通常包括电子邮件地址，个人姓名等。
date 描述了[:"ChangeSet":改变集]是什么时候创建的。这些时间是创建[:"ChangeSet":改变集]的人所在区域的当地时间。
summary 给出了[:"ChangeSet":改变集]描述的首行。它是在创建[:"ChangeSet":改变集]时进入的，它可以帮助创建者和其它人了解[:"ChangeSet":改变集]的目的。
parent 标志了[:"ChangeSet":改变集]的父辈，当你从几个仓库合并而来的情况下，父辈有多个。
- 大多数情况只有一个父辈，它比目前的改变集旧。这是在我们例子中使用的。
我们可以通过指定-v诊断输出选项来获得更多更详细的历史信息, 或者指定--debug选项来获得历史信息中的一切细节:
$ hg log -v changeset: 1:82e55d328c8ca4ee16520036c0aaace03a5beb65 tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 files: Makefile description: Create a makefile (...) $ hg log --debug manifest: 1:0c7c1d435e6703e03ac6634a7c32da3a082d1600 changeset: 1:82e55d328c8ca4ee16520036c0aaace03a5beb65 tag: tip parent: 0:0a04b987be5ae354b710cefeba0e2d9de7ad41a9 parent: -1:0000000000000000000000000000000000000000 user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 files+: Makefile description: Create a makefile (...)
--v的输出比缺省输出要多。
changeset 给出不缩略的[:ChangSetID:改变集标号]。
files 列出在本[:"ChangeSet":改变集]中文件的改变。
description 包含了[:"ChangeSet":改变集]的完整多行描述而不仅是头一行。
- 在我们例子中，描述都只有一行，所以没什么特别不同的地方。
--debug 给谓词输出添加了以下方面：
file+ 列出了在此改变集中增加的文件。
file- 列出了在此改变集中删除的文件。
manifest 给这个改变集一个 ["Manifest"] 号。
两个 parent 域给这个改变集的两个父辈号码， -1:0000000000000000000000000000000000000000 表示没有父改变集。
log 命令与 -r 选项一起使用可以查看特定改变集。
$ hg log -r1 changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile
The -r 选项实际上支持一种非常灵活的语法来选择改变集的范围。但是由于在我们例子的仓库里的改变集很有限，我们不能做很好的示范。你可以看 Mercurial 的 [http://www.selenic.com/mercurial/hg.1.html manpage] 来得到更多的信息。
log 命令与 -p 选项一起可以显示和此改变集相关联的补丁。
$ hg log -r1 -p changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile diff -r 0a04b987be5a -r 82e55d328c8c Makefile --- /dev/null Fri Aug 26 01:20:50 2005 -0700 +++ b/Makefile Fri Aug 26 01:21:28 2005 -0700 @@ -0,0 +1,1 @@ +all: hello
我们也可以使用 tip 命令来显示 tip 的信息，如最后的改变集。 tip 命令除了不支持 -p 选项外，它可以当做 log -r tip 的快捷方式，
$ hg tip changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile $ hg log -r tip changeset: 1:82e55d328c8c tag: tip user: mpm@selenic.com date: Fri Aug 26 01:21:28 2005 -0700 summary: Create a makefile
现在我们对发生了什么有了一点概念，现在让我们进入并做一些修改吧！进入 [:ChineseTutorialFirstChange:教程 - 生成第一个[变更]]!