doc: commit: synchronize <pathspec> description

`git add` shows an example of good writing, follow it.
This also better disambiguates <file>... header.

Signed-off-by: Alexandr Miloslavskiy <alexandr.miloslavskiy@syntevo.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt
index afa7b75a23dac0aed3884b7015da0357996b8ff3..a0c44978ee0bbb0de53432ca78fd9f305607ae3f 100644 (file)
--- a/Documentation/git-commit.txt
+++ b/Documentation/git-commit.txt
@@ -13,7 +13,7 @@ SYNOPSIS
           [-F <file> | -m <msg>] [--reset-author] [--allow-empty]
           [--allow-empty-message] [--no-verify] [-e] [--author=<author>]
           [--date=<date>] [--cleanup=<mode>] [--[no-]status]
-          [-i | -o] [-S[<keyid>]] [--] [<file>...]
+          [-i | -o] [-S[<keyid>]] [--] [<pathspec>...]
 
 DESCRIPTION
 -----------
@@ -345,12 +345,13 @@ changes to tracked files.
 \--::
        Do not interpret any more arguments as options.
 
-<file>...::
-       When files are given on the command line, the command
-       commits the contents of the named files, without
-       recording the changes already staged.  The contents of
-       these files are also staged for the next commit on top
-       of what have been staged before.
+<pathspec>...::
+       When pathspec is given on the command line, commit the contents of
+       the files that match the pathspec without recording the changes
+       already added to the index. The contents of these files are also
+       staged for the next commit on top of what have been staged before.
++
+For more details, see the 'pathspec' entry in linkgit:gitglossary[7].
 
 :git-commit: 1
 include::date-formats.txt[]