[PATCH 3/3] Remove definition of refspec and pathspec from glossary-content.txt

2013-04-02 Thread Thomas Ackermann

Signed-off-by: Thomas Ackermann th.ac...@arcor.de
---
 Documentation/glossary-content.txt | 65 ++
 1 file changed, 3 insertions(+), 62 deletions(-)

diff --git a/Documentation/glossary-content.txt 
b/Documentation/glossary-content.txt
index 05bfebc..1c9c522 100644
--- a/Documentation/glossary-content.txt
+++ b/Documentation/glossary-content.txt
@@ -261,59 +261,7 @@ This commit is referred to as a merge commit, or 
sometimes just a
pack.
 
 [[def_pathspec]]pathspec::
-   Pattern used to specify paths.
-+
-Pathspecs are used on the command line of git ls-files, git
-ls-tree, git add, git grep, git diff, git checkout,
-and many other commands to
-limit the scope of operations to some subset of the tree or
-worktree.  See the documentation of each command for whether
-paths are relative to the current directory or toplevel.  The
-pathspec syntax is as follows:
-
-* any path matches itself
-* the pathspec up to the last slash represents a
-  directory prefix.  The scope of that pathspec is
-  limited to that subtree.
-* the rest of the pathspec is a pattern for the remainder
-  of the pathname.  Paths relative to the directory
-  prefix will be matched against that pattern using fnmatch(3);
-  in particular, '*' and '?' _can_ match directory separators.
-+
-For example, Documentation/*.jpg will match all .jpg files
-in the Documentation subtree,
-including Documentation/chapter_1/figure_1.jpg.
-
-+
-A pathspec that begins with a colon `:` has special meaning.  In the
-short form, the leading colon `:` is followed by zero or more magic
-signature letters (which optionally is terminated by another colon `:`),
-and the remainder is the pattern to match against the path. The optional
-colon that terminates the magic signature can be omitted if the pattern
-begins with a character that cannot be a magic signature and is not a
-colon.
-+
-In the long form, the leading colon `:` is followed by a open
-parenthesis `(`, a comma-separated list of zero or more magic words,
-and a close parentheses `)`, and the remainder is the pattern to match
-against the path.
-+
-The magic signature consists of an ASCII symbol that is not
-alphanumeric.
-+
---
-top `/`;;
-   The magic word `top` (mnemonic: `/`) makes the pattern match
-   from the root of the working tree, even when you are running
-   the command from inside a subdirectory.
---
-+
-Currently only the slash `/` is recognized as the magic signature,
-but it is envisioned that we will support more types of magic in later
-versions of Git.
-+
-A pathspec with only a colon means there is no pathspec. This form
-should not be combined with other pathspec.
+   Pattern used to specify paths in Git commands.
 
 [[def_parent]]parent::
A def_commit_object,commit object contains a (possibly empty) list
@@ -382,15 +330,8 @@ should not be combined with other pathspec.
 [[def_refspec]]refspec::
A refspec is used by def_fetch,fetch and
def_push,push to describe the mapping between remote
-   def_ref,ref and local ref. They are combined with a colon in
-   the format src:dst, preceded by an optional plus sign, +.
-   For example: `git fetch $URL
-   refs/heads/master:refs/heads/origin` means grab the master
-   def_branch,branch def_head,head from the $URL and store
-   it as my origin branch head. And `git push
-   $URL refs/heads/master:refs/heads/to-upstream` means publish my
-   master branch head as to-upstream branch at $URL. See also
-   linkgit:git-push[1].
+   def_ref,ref and local ref. 
+   See linkgit:git-push[1] for details.
 
 [[def_remote_tracking_branch]]remote-tracking branch::
A regular Git def_branch,branch that is used to follow changes from
-- 
1.8.1.msysgit.1


---
Thomas
--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Re: [PATCH 3/3] Remove definition of refspec and pathspec from glossary-content.txt

2013-04-02 Thread Junio C Hamano
Thomas Ackermann th.ac...@arcor.de writes:

 Signed-off-by: Thomas Ackermann th.ac...@arcor.de
 ---
  Documentation/glossary-content.txt | 65 
 ++
  1 file changed, 3 insertions(+), 62 deletions(-)

 diff --git a/Documentation/glossary-content.txt 
 b/Documentation/glossary-content.txt
 index 05bfebc..1c9c522 100644
 --- a/Documentation/glossary-content.txt
 +++ b/Documentation/glossary-content.txt
 @@ -261,59 +261,7 @@ This commit is referred to as a merge commit, or 
 sometimes just a
   pack.
  
  [[def_pathspec]]pathspec::
 +   Pattern used to specify paths in Git commands.

Strictly speaking, it is used to limit, but in the context of this
document it shouldn't matter either way.

  
  [[def_parent]]parent::
   A def_commit_object,commit object contains a (possibly empty) list
 @@ -382,15 +330,8 @@ should not be combined with other pathspec.
  [[def_refspec]]refspec::
   A refspec is used by def_fetch,fetch and
   def_push,push to describe the mapping between remote
 + def_ref,ref and local ref. 
 + See linkgit:git-push[1] for details.

I think we can just drop See ... for details from here.  Besides,
why just push and not fetch?
--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Aw: Re: [PATCH 3/3] Remove definition of refspec and pathspec from glossary-content.txt

2013-04-02 Thread Thomas Ackermann
 
 
 I think we can just drop See ... for details from here.  Besides,
 why just push and not fetch?
 

I just kept the original reference which only linked to git-push.


---
Thomas
--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Re: Aw: Re: [PATCH 3/3] Remove definition of refspec and pathspec from glossary-content.txt

2013-04-02 Thread Junio C Hamano
Thomas Ackermann th.ac...@arcor.de writes:

  
 
 I think we can just drop See ... for details from here.  Besides,
 why just push and not fetch?
 

 I just kept the original reference which only linked to git-push.

That is only because the last example the See ... for details
refers to is about 'git push', isn't it?
--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Aw: Re: Aw: Re: [PATCH 3/3] Remove definition of refspec and pathspec from glossary-content.txt

2013-04-02 Thread Thomas Ackermann
 
 
 That is only because the last example the See ... for details
 refers to is about 'git push', isn't it?
 
This is correct but there was no direct link to git-fetch in the first example
and I did not check which combination of man pages gives the complete
definition of refspecs ...


---
Thomas
--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html