Re: [RFC/PATCH 2/3] Documentation: gitrevisions

From: Stephen Boyd <bebarino@gmail.com>
Date: Jul 14, 2010, 06:16 UTC
Message-ID: <4C3D562B.3070404@gmail.com>
In-Reply-To: <7efed85cefddff1cd2cc3a0e3802326306117f4e.1278346173.git.git@drmicha.warpmail.net>

  On 07/05/2010 09:11 AM, Michael J Gruber wrote:

Show 14 quoted lines

> +
> +DESCRIPTION
> +-----------
> +
> +Many Git commands take revision parameters as arguments. Depending on
> +the command, they denote a specific commit or, for commands which
> +walk the revision graph (such as linkgit:git-log[1]), all commits which can
> +be reached from that commit. In the latter case one can also specify a
> +range of revisions explicitly.
> +
> +In addition, some Git commands (such as linkgit:git-show[1]) also take
> +revision parameters which denote other objects than commits, e.g. blobs
> +("files") or trees ("directories of files").
> +

Is any of this text (section?) necessary besides including revisions.txt? It seems that revisions.txt nicely covers the types of revisions in the first paragraph of each section and these two paragraphs repeat that.

Can you squash this in?

--->8----

index fc4789f..0e25c5f 100644

--- a/Documentation/gitrevisions.txt
+++ b/Documentation/gitrevisions.txt
@@ -10,19 +10,6 @@ SYNOPSIS
  gitrevisions


-DESCRIPTION
------------
-
-Many Git commands take revision parameters as arguments. Depending on
-the command, they denote a specific commit or, for commands which
-walk the revision graph (such as linkgit:git-log[1]), all commits which can
-be reached from that commit. In the latter case one can also specify a
-range of revisions explicitly.
-
-In addition, some Git commands (such as linkgit:git-show[1]) also take
-revision parameters which denote other objects than commits, e.g. blobs
-("files") or trees ("directories of files").
-
  include::revisions.txt[]