git-tfs/doc/commands/fetch.md

Summary

The fetch command fetch all the new changesets from a TFS remote

Synopsis

Usage: git-tfs fetch [options] [tfs-remote-id]...
  -h, -H, --help
  -V, --version
  -d, --debug                Show debug output about everything git-tfs does
  -i, --tfs-remote, --remote, --id=VALUE
                             The remote ID of the TFS to interact with
                               default: default
      --all, --fetch-all
      --parents
      --authors=VALUE        Path to an Authors file to map TFS users to Git
                               users
      --ignore-regex=VALUE   a regex of files to ignore
      --no-metadata          leave out the 'git-tfs-id:' tag in commit
                               messages
                               Use this when you're exporting from TFS and
                               don't need to put data back into TFS.
  -u, --username=VALUE       TFS username
  -p, --password=VALUE       TFS password

Examples

Simple

To fetch all the changeset of the default branch:

git tfs fetch

Fetch from a branch

To fetch all the changeset of the tfs/myBranch branch:

git tfs fetch -i myBranch

Authentication

For the use of parameters --username and --password, see the clone command.

Map TFS users to git users

For the use of parameter --authors, see the clone command.

Fetching merge changesets

Merge changesets will be automatically fetched and created as a merge commit if the tfs branch merged has already inited in the git repository. If the tfs branch merged has not be inited, the merge changeset will be created as a normal commit (not a merged one) and this warning message will be created :

warning: found merge changeset 34 but unable to manage it due to lack of local commit for changeset 33! Fetch the corresponding branch before...

See also

• clone