From: Alexandr Miloslavskiy Date: Tue, 19 Nov 2019 16:53:41 GMT Subject: Re: [PATCH v2 5/6] doc: commit: unify description Message-ID: <839aaf51-147f-19b2-514f-bf9b1ea78101@syntevo.com> In-Reply-To: On 19.11.2019 7:16, Junio C Hamano wrote: >> +For more details about the syntax, see the 'pathspec' entry >> +in linkgit:gitglossary[7]. > > What you added in [PATCH 3/6] (git reset doc) sends a slightly > different message, i.e. > > The is used to limit the paths affected by the operation > (see the entry for 'pathspec' in linkgit:gitglossary[7] for more details). > > and I think that was more appropriate than what we see here. You > are referring your readers to the glossary entry not just for the > syntax but also the entire concept of . > > IOW, it would be needed to drop "syntax" from "about the > syntax" from here to match the update to "git reset" documentation. I shortened it even more in V3, I think it's better now?