Files
Peter Baumann 5a010df682 Remove --no-metadata from documentation
The feature is gone since v0.17.0 and was removed in
4c2ab71e ("Remove unused config no-meta-data (see #281, #283).", 2013-01-10)

Remove the leftover comments to avoid any further confusion.
Note: For removing the `git-tfs-id:` markers at the end of the commit
message, see the howto at https://github.com/git-tfs/git-tfs/blob/master/doc/usecases/migrate_tfs_to_git.md#clean-commits-optional
2022-12-14 19:16:42 +01:00

2.0 KiB

Summary

The init command creates a new git repository, initialized from a TFS source tree (without fetching the changesets). Fetching changeset should be done with fetch command.

Prefer the clone command to initialize and fetch changesets from a TFS repository!

Synopsis

Usage: git-tfs init [options] tfs-url-or-instance-name repository-path [git-repository]
  -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
      --template=VALUE       Passed to git-init
      --shared[=VALUE]       Passed to git-init
      --initial-branch=VALUE Passed to git-init (requires Git >= 2.28.0)
      --autocrlf=VALUE       Normalize line endings (default: false)
      --ignorecase=VALUE     Ignore case in file paths (default: system
                                 default)
      --bare                 clone the TFS repository in a bare git repository
      --workspace=VALUE      set tfs workspace to a specific folder (a
                               shorter path is better!)
      --ignore-regex=VALUE   a regex of files to ignore
  -u, --username=VALUE       TFS username
  -p, --password=VALUE       TFS password
      --no-parallel          Do not do parallel requests to TFS

Examples

Simple

To initialize $/Project1 from your TFS 2010 server tfs into a new directory Project1, do this:

git tfs init http://tfs:8080/tfs/DefaultCollection $/Project1

then, to retrieve tfs changesets do this :

git tfs pull

Note: [pull] is here preferred to [fetch], otherwise the git branch master won't be created :(

See also