From: Jonathan Nieder <jrnieder@gmail.com>
Date: Sat, 18 Dec 2010 08:39:25 GMT
Subject: Re: [PATCH 7/8] docs: use <commit> instead of <commit-ish>
Message-ID: <20101218083925.GD6187@burratino>
In-Reply-To: <1292650725-21149-8-git-send-email-lodatom@gmail.com>

Mark Lodato wrote:

> --- a/Documentation/git-describe.txt
> +++ b/Documentation/git-describe.txt
> @@ -26,8 +26,8 @@ see the -a and -s options to linkgit:git-tag[1].
>  
>  OPTIONS
>  -------
> -<committish>...::
> -	Committish object names to describe.
> +<commit>...::
> +	Commit object names to describe.

Or even

	Commits to describe.

:)

> --- a/Documentation/git-fast-import.txt
> +++ b/Documentation/git-fast-import.txt
> @@ -350,8 +350,8 @@ change to the project.
>  	('author' (SP <name>)? SP LT <email> GT SP <when> LF)?
>  	'committer' (SP <name>)? SP LT <email> GT SP <when> LF
>  	data
> -	('from' SP <committish> LF)?
> -	('merge' SP <committish> LF)?
> +	('from' SP <commit> LF)?
> +	('merge' SP <commit> LF)?

As the audience of this manual page is people mostly familiar with
other version control systems, it needs to be very explicit.  Not sure
what the best solution is, just pointing out the worry.