Indicate that repository and refspec are now optional on push and pull.

Add notes to add, push and pull about storing values in .gitsubtree
and their use as default values.

Signed-off-by: Paul Campbell <>
 contrib/subtree/git-subtree.txt | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/contrib/subtree/git-subtree.txt b/contrib/subtree/git-subtree.txt
index 7ba853e..2ad9278 100644
--- a/contrib/subtree/git-subtree.txt
+++ b/contrib/subtree/git-subtree.txt
@@ -11,8 +11,8 @@ SYNOPSIS
 'git subtree' add   -P <prefix> <refspec>
 'git subtree' add   -P <prefix> <repository> <refspec>
-'git subtree' pull  -P <prefix> <repository> <refspec...>
-'git subtree' push  -P <prefix> <repository> <refspec...>
+'git subtree' pull  -P [<prefix> <repository> <refspec...>]
+'git subtree' push  -P [<prefix> <repository> <refspec...>]
 'git subtree' merge -P <prefix> <commit>
 'git subtree' split -P <prefix> [OPTIONS] [<commit>]

@@ -72,7 +72,9 @@ add::
        A new commit is created automatically, joining the imported
        project's history with your own.  With '--squash', imports
        only a single commit from the subproject, rather than its
-       entire history.
+       entire history. Details of the <prefix> are added to the
+       .gitsubtree file, where they will be used as defaults for
+       'push' and 'pull'.

        Merge recent changes up to <commit> into the <prefix>
@@ -91,13 +93,16 @@ merge::
        Exactly like 'merge', but parallels 'git pull' in that
        it fetches the given commit from the specified remote
-       repository.
+       repository. Default values for <repository> and <refspec>
+       are taken from the .gitsubtree file.
        Does a 'split' (see below) using the <prefix> supplied
        and then does a 'git push' to push the result to the
        repository and refspec. This can be used to push your
        subtree to different branches of the remote repository.
+       Default values for <repository> and <refspec> are taken
+       from the .gitsubtree file.

        Extract a new, synthetic project history from the
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to
More majordomo info at

Reply via email to