Make sure that <prefix> exists when splitting.
[gitweb.git] / git-subtree.txt
index e7ce2d3654dcce65b2b983f3bc76bdd22ca939ec..2200aaeaf2868d7a413d2f96b86e929267533d2e 100644 (file)
@@ -223,8 +223,8 @@ OPTIONS FOR split
        subproject's history to be part of your project anyway.
 
 
-EXAMPLES
---------
+EXAMPLE 1
+---------
 Let's use the repository for the git source code as an example. 
 First, get your own copy of the git.git repository:
 
@@ -258,7 +258,7 @@ And you can merge changes back in from the upstream project just
 as easily:
 
        $ git subtree pull --prefix=gitweb \
-               git@github.com:whatever/gitweb.git gitweb-latest:master
+               git@github.com:whatever/gitweb.git master
 
 Or, using '--squash', you can actually rewind to an earlier
 version of gitweb:
@@ -284,6 +284,23 @@ the standard gitweb:
 
        git log gitweb-latest..$(git subtree split --prefix=gitweb)
 
+EXAMPLE 2
+---------
+Suppose you have a source directory with many files and
+subdirectories, and you want to extract the lib directory to its own
+git project. Here's a short way to do it:
+
+First, make the new repository wherever you want:
+       <go to the new location>
+       git init --bare
+
+Back in your original directory:
+       git subtree split --prefix=lib --annotate="(split)" -b split
+
+Then push the new branch onto the new empty repository:
+        git push <new-repo> split:master
+
+
 
 AUTHOR
 ------