{"thread":{"id":"694","subject":"[PATCH 3/5] Docs - include README in git.txt","startedAt":"2005-05-22T17:44:16Z","lastAt":"2005-05-22T17:44:16Z","messageCount":1,"participants":["David Greaves"],"isPatch":true,"patchVersion":1,"patchTotal":5},"messages":[{"id":"3762","messageId":"E1DZuUq-0008Gc-O2@ash.dgreaves.com","threadId":"694","inReplyTo":null,"subject":"[PATCH 3/5] Docs - include README in git.txt","fromName":"David Greaves","fromEmail":"david@dgreaves.com","sentAt":"2005-05-22T17:44:16Z","receivedAt":"2005-05-22T17:44:16Z","isPatch":true,"sender":{"key":"david@dgreaves.com","avatar":"https://gravatar.com/avatar/ca67bad50999edcdd137c9a65da2381557d175bea99ae956afdabc5785e42b79?d=mp&s=160"},"body":"Include the README in the git.txt\n\nSigned-off-by: David Greaves <david@dgreaves.com>\n\n---\ncommit e6d7c5341942fdd07d966efe36fde653167e84f0\ntree 03ae742170ebaef9040fa8234e1d6752bad140ab\nparent 6f657e57d7a5b941ed401365e23d78ff77f5ebcf\nauthor David Greaves <david@dgreaves.com> Sat, 21 May 2005 21:27:41 +0100\ncommitter David Greaves <david@dgreaves.com> Sat, 21 May 2005 21:27:41 +0100\n\n Documentation/git.txt |   46 +++++++++++++++++++++-------------------------\n 1 files changed, 21 insertions(+), 25 deletions(-)\n\nIndex: Documentation/git.txt\n===================================================================\n--- c081754f951815c43bdd973ddc7e23365793e75e/Documentation/git.txt  (mode:100644)\n+++ 03ae742170ebaef9040fa8234e1d6752bad140ab/Documentation/git.txt  (mode:100644)\n@@ -1,6 +1,6 @@\n git(7)\n ======\n-v0.1, May 2005\n+May 2005\n \n NAME\n ----\n@@ -16,9 +16,10 @@\n \n This is reference information for the core git commands.\n \n-The link:README[] contains much useful definition and clarification\n-info - read that first.  And of the commands, I suggest reading\n-'git-update-cache' and 'git-read-tree' first - I wish I had!\n+The Discussion section below contains much useful definition and\n+clarification info - read that first.  And of the commands, I suggest\n+reading link:git-update-cache.html[git-update-cache] and\n+link:git-read-tree.html[git-read-tree] first - I wish I had!\n \n David Greaves <david@dgreaves.com>\n 08/05/05\n@@ -157,14 +158,10 @@\n \n \n \n-Terminology\n------------\n-see README for description\n-\n-Identifier terminology\n+Identifier Terminology\n ----------------------\n <object>::\n-\tIndicates any object sha1 identifier\n+\tIndicates the sha1 identifier for any type of object\n \n <blob>::\n \tIndicates a blob object sha1 identifier\n@@ -176,11 +173,10 @@\n \tIndicates a commit object sha1 identifier\n \n <tree-ish>::\n-\tIndicates a tree, commit or tag object sha1 identifier.\n-\tA command that takes a <tree-ish> argument ultimately\n-\twants to operate on a <tree> object but automatically\n-\tdereferences <commit> and <tag> that points at a\n-\t<tree>.\n+\tIndicates a tree, commit or tag object sha1 identifier.  A\n+\tcommand that takes a <tree-ish> argument ultimately wants to\n+\toperate on a <tree> object but automatically dereferences\n+\t<commit> and <tag> objects that point at a <tree>.\n \n <type>::\n \tIndicates that an object type is required.\n@@ -192,10 +188,12 @@\n \n Symbolic Identifiers\n --------------------\n-Any git comand accepting any <object> can also use the following symbolic notation:\n+Any git comand accepting any <object> can also use the following\n+symbolic notation:\n \n HEAD::\n-\tindicates the head of the repository (ie the contents of `$GIT_DIR/HEAD`)\n+\tindicates the head of the repository (ie the contents of\n+\t`$GIT_DIR/HEAD`)\n <tag>::\n \ta valid tag 'name'+\n \t(ie the contents of `$GIT_DIR/refs/tags/<tag>`)\n@@ -230,18 +228,12 @@\n \n Terminology\n -----------\n-Each line contains terms used interchangeably\n+Each line contains terms which you may see used interchangeably\n \n  object database, .git directory\n  directory cache, index\n  id, sha1, sha1-id, sha1 hash\n  type, tag\n- blob, blob object\n- tree, tree object\n- commit, commit object\n- parent\n- root object\n- changeset\n \n \n Environment Variables\n@@ -295,9 +287,13 @@\n \tlink:git-diff-files.html[git-diff-files];\n \tlink:git-diff-tree.html[git-diff-tree]\n \n+Discussion\n+----------\n+include::../README[]\n+\n Author\n ------\n-Written by Linus Torvalds <torvalds@osdl.org>\n+Written by Linus Torvalds <torvalds@osdl.org> and the git-list <git@vger.kernel.org>.\n \n Documentation\n --------------\n"}]}