From mboxrd@z Thu Jan 1 00:00:00 1970 From: Krzysztof Mazur Subject: Re: git-reset man page Date: Sat, 10 Nov 2012 16:57:18 +0100 Message-ID: <20121110155718.GA29321@shrek.podlesie.net> References: Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-2 Content-Transfer-Encoding: QUOTED-PRINTABLE Cc: git , peff@peff.net To: Angelo Borsotti X-From: git-owner@vger.kernel.org Sat Nov 10 17:04:05 2012 Return-path: Envelope-to: gcvg-git-2@plane.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TXDXR-0003hh-A5 for gcvg-git-2@plane.gmane.org; Sat, 10 Nov 2012 17:04:05 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752061Ab2KJQDt convert rfc822-to-quoted-printable (ORCPT ); Sat, 10 Nov 2012 11:03:49 -0500 Received: from shrek-modem1.podlesie.net ([83.18.25.171]:55545 "EHLO shrek.podlesie.net" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751991Ab2KJQDt (ORCPT ); Sat, 10 Nov 2012 11:03:49 -0500 X-Greylist: delayed 386 seconds by postgrey-1.27 at vger.kernel.org; Sat, 10 Nov 2012 11:03:48 EST Received: by shrek.podlesie.net (Postfix, from userid 603) id C0592707; Sat, 10 Nov 2012 16:57:18 +0100 (CET) Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Sat, Nov 10, 2012 at 10:55:13AM +0100, Angelo Borsotti wrote: > Hi >=20 > the man page of git-reset, synopsys, does not allow for an > argumentless call, and the description does not tell either what is > the meaning of it. This issue was already reported by Bojan Petrovi=E6: http://thread.gmane.org/gmane.comp.version-control.git/208505 and fixed in commit d505865be5c7d72abb74318940e8c4c52aa0db5f (doc: git-reset: make "" optional) in master branch. "git reset" is equivalent to "git reset --mixed". > Suggested changes: >=20 > first line of synopsis: >=20 > gitt reset [-q] [] [ [--] ...] >=20 > Description: append to the end of the first paragraph: >=20 > "If no are specified, all the index entries are rese= t." >=20 > I would suggest to change with in all the man page > because paths in the glossary are called pathspecs. >=20 The issue seems to be bigger - "", "" and "" are mixed in whole manual: $ cat Documentation/*.txt | grep -o ']*>' | sort | uniq -c | sort -n -r 125 17 10 2 2 1 1 In commands it's even worse: $ cat builtin/*.c | grep -o ']*>' | sort | uniq -c | sort -n -r 14 15 Note: is not always used for pathspec. In git-checkout manual in synopsis "" is used, but in descriptio= n "". Maybe we should just add that is an shortcut for and fix places where paths and pathspec are mixed or is used as . Thanks, Krzysiek