Matt Burke
54 lines
2.2 KiB
Markdown
54 lines
2.2 KiB
Markdown
# Git-tfs config values
|
|
|
|
Git-tfs uses git's configuration system to track most of the important
|
|
information about repositories.
|
|
|
|
## Repository-wide configuration
|
|
|
|
By default, git-tfs sets these configuration values for the repository
|
|
during `git tfs init`.
|
|
|
|
* `core.ignorecase` is set to `true`, in an attempt to deal with
|
|
casing issues.
|
|
* `core.autocrlf` is set to `false`. This will make git preserve all
|
|
characters (including CR and LF) in all files. The reason for doing
|
|
this is to make the result of `git tfs clone` as nearly identical,
|
|
byte-wise, as possible, to the version in TFS.
|
|
|
|
## Per-TFS remote
|
|
|
|
Git-tfs can map multiple TFS branches to git branches. Each TFS
|
|
branch is tracked as a separate "remote", and several config values
|
|
are stored for each branch.
|
|
|
|
Each git-tfs remote is assigned an ID. All of a remote's config keys
|
|
are prefixed with `tfs-remote.<id>.` So, for example, the full `url`
|
|
key for the remote `default` is `tfs-remote.default.url`.
|
|
|
|
* `url`
|
|
is the URL of the TFS project collection.
|
|
* `legacy-urls`
|
|
is a list, comma-separated, of previous URLs of the TFS project
|
|
collection. For example, if you started your git-tfs clone from
|
|
a 2005 or 2008 TFS server ('http://tfs:8080/tfs'), and the server
|
|
migrated to 2010 or later, moving your project into a project
|
|
collection ('http://tfs:8080/tfs/DefaultCollection'), then the
|
|
`url` for your git-tfs remote should be the current url, and
|
|
`legacy-urls` would be the old url.
|
|
* `repository`
|
|
is the TFS repository path that was cloned to the root of your
|
|
git-tfs project. Typically this is a TFS project path
|
|
(`$/MyProject`), but it can be a subdirectory (`$/MyProject/Dir`)
|
|
or a branch (`$/MyProject/trunk`).
|
|
* `username` and `password`
|
|
are your TFS credentials. Normally, if you connect to a TFS
|
|
server on your local Windows domain, you won't need to provide
|
|
these values, because git-tfs defaults to using integrated
|
|
authentication.
|
|
* `ignore-paths`
|
|
is a regular expression of TFS paths to ignore when fetching.
|
|
* `autotag`
|
|
can be set to `true` to make git-tfs create a tag for each
|
|
TFS commit. This is disabled by default, because creating
|
|
a lot of tags will slow down your git operations.
|