diff --git a/doc/commands/clone.md b/doc/commands/clone.md index 03c6b7cb..d5d1bd9c 100644 --- a/doc/commands/clone.md +++ b/doc/commands/clone.md @@ -34,6 +34,7 @@ a TFS source tree and fetch all the changesets Path to Work-items mapping export file --ignore-branches Ignore fetching merged branches when encounter merge changesets --batch-size=VALUE Size of a the batch of tfs changesets fetched (-1 for all in one batch) + -c, --changeset=VALUE The changeset to clone from (must be a number) --with-branches init all the TFS branches during the clone --resumable if an error occurred, try to continue when you restart clone with same parameters @@ -45,6 +46,18 @@ into a new directory `Project1`, do this: git tfs clone http://tfs:8080/tfs/DefaultCollection $/Project1 +### Clone from a specific changeset + +To clone from a specific changeset in the history of `$/Project1` from your TFS server `tfs` +into a new directory `Project1`, do this: + + git tfs clone http://tfs:8080/tfs/DefaultCollection $/Project1 -c=126 + +where `126` is the id of the changeset to clone. + +This command will get all the history from this specific changeset. +It could be especially useful when you have a huge history and also when the entire history could not be clone due to not supported tfs specificities! + ### Clone only the trunk (with dependency branches) Sometimes, it could be interesting to clone only a branch of a TFS repository (for example to extract only the trunk of your project and manage branches using the [branch](branch.md) command. diff --git a/doc/commands/quick-clone.md b/doc/commands/quick-clone.md index a51d1065..278701cf 100644 --- a/doc/commands/quick-clone.md +++ b/doc/commands/quick-clone.md @@ -1,6 +1,6 @@ ## Summary -The quick-clone command creates a new git repository, initialized from the last change-set in a TFS source tree, ignoring the full history. +The quick-clone command creates a new git repository, initialized from the last changeset (or a specific changeset in history) in a TFS source tree, ignoring the full history. Useful for making code changes or additions where past history isn't relevant. ## Synopsis diff --git a/doc/release-notes/NEXT.md b/doc/release-notes/NEXT.md index 732a46d8..db6ad4ac 100644 --- a/doc/release-notes/NEXT.md +++ b/doc/release-notes/NEXT.md @@ -1,4 +1,5 @@ * Add Vs2015 (and TFS2015) support (#760, @pmiossec) +* Initialize a branch when not finding the root commit in the repository (#789, @pmiossec) * Manage the case where files are added when renaming a tfs branch (#718, @pmiossec) * Being able to clone from a specific changeset (#784, @pmiossec) -* Rcheckin with libgit2sharp (#605, @pmiossec) \ No newline at end of file +* Rcheckin with libgit2sharp (#605, @pmiossec)