From: Mark Lodato Date: Sat, 18 Dec 2010 05:38:40 GMT Subject: [PATCH 3/8] docs: use to mean unabbreviated ID Message-ID: <1292650725-21149-4-git-send-email-lodatom@gmail.com> In-Reply-To: <1292650725-21149-1-git-send-email-lodatom@gmail.com> There are some places that literally require a full, 40-character SHA-1 ID, rather than a generic revision specifier. Introduce in git(1) the terminology to mean this. Use in git-diff-tree(1) to note that --stdin only takes s, not generic s or s. Use and in the usage statement for 'commit-tree'. Signed-off-by: Mark Lodato --- Documentation/git-diff-tree.txt | 4 ++-- Documentation/git.txt | 5 +++++ builtin/commit-tree.c | 2 +- 3 files changed, 8 insertions(+), 3 deletions(-) diff --git a/Documentation/git-diff-tree.txt b/Documentation/git-diff-tree.txt index a7e37b8..6b357a5 100644 --- a/Documentation/git-diff-tree.txt +++ b/Documentation/git-diff-tree.txt @@ -49,8 +49,8 @@ include::diff-options.txt[] --stdin:: When '--stdin' is specified, the command does not take arguments from the command line. Instead, it - reads lines containing either two , one , or a - list of from its standard input. (Use a single space + reads lines containing s: either two trees, one commit, or + multiple commits from its standard input. (Use a single space as separator.) + When two trees are given, it compares the first tree with the second. diff --git a/Documentation/git.txt b/Documentation/git.txt index 0128371..7929739 100644 --- a/Documentation/git.txt +++ b/Documentation/git.txt @@ -457,6 +457,11 @@ list. Identifier Terminology ---------------------- +:: + Indicates a full, 40-character SHA-1 identifier of an object. + The type of the referenced object is unspecified. + Abbreviated or symbolic identifiers cannot be used. + :: Indicates the object name for any type of object. diff --git a/builtin/commit-tree.c b/builtin/commit-tree.c index d083795..da572c3 100644 --- a/builtin/commit-tree.c +++ b/builtin/commit-tree.c @@ -9,7 +9,7 @@ #include "builtin.h" #include "utf8.h" -static const char commit_tree_usage[] = "git commit-tree [(-p )...] < changelog"; +static const char commit_tree_usage[] = "git commit-tree [(-p )...] < changelog"; static void new_parent(struct commit *parent, struct commit_list **parents_p) { -- 1.7.3.2