projects / thirdparty / git.git / blame
| Commit | Line | Data |
|---|---|---|
| 2d2465c0 JS |
1 | git-config-set(1) |
| 2 | =============== | |
| 3 | ||
| 4 | NAME | |
| 5 | ---- | |
| 6 | git-config-set - Set options in .git/config. | |
| 7 | ||
| 8 | ||
| 9 | SYNOPSIS | |
| 10 | -------- | |
| 11 | 'git-config-set' ( name [value [value_regex]] | --unset name [value_regex] ) | |
| 12 | ||
| 13 | DESCRIPTION | |
| 14 | ----------- | |
| 15 | You can set/replace/unset options with this command. The name is actually | |
| 16 | the section and the key separated by a dot, and the value will be escaped. | |
| 17 | ||
| 18 | If you want to set/unset an option which can occor on multiple lines, you | |
| 19 | should provide a POSIX regex for the value. | |
| 20 | ||
| 21 | This command will fail if | |
| 22 | ||
| 23 | . .git/config is invalid, | |
| 24 | . .git/config can not be written to, | |
| 25 | . no section was provided, | |
| 26 | . the section or key is invalid, | |
| 27 | . you try to unset an option which does not exist, or | |
| 28 | . you try to unset/set an option for which multiple lines match. | |
| 29 | ||
| 30 | ||
| 31 | OPTIONS | |
| 32 | ------- | |
| 33 | ||
| 34 | --unset:: | |
| 35 | Remove the given option from .git/config | |
| 36 | ||
| 37 | ||
| 38 | EXAMPLE | |
| 39 | ------- | |
| 40 | ||
| 41 | Given a .git/config like this: | |
| 42 | ||
| 43 | # | |
| 44 | # This is the config file, and | |
| 45 | # a '#' or ';' character indicates | |
| 46 | # a comment | |
| 47 | # | |
| 48 | ||
| 49 | ; core variables | |
| 50 | [core] | |
| 51 | ; Don't trust file modes | |
| 52 | filemode = false | |
| 53 | ||
| 54 | ; Our diff algorithm | |
| 55 | [diff] | |
| 56 | external = "/usr/local/bin/gnu-diff -u" | |
| 57 | renames = true | |
| 58 | ||
| 59 | ; Proxy settings | |
| 60 | [proxy] | |
| 61 | command="ssh" for "ssh://kernel.org/" | |
| 62 | command="proxy-command" for kernel.org | |
| 63 | command="myprotocol-command" for "my://" | |
| 64 | ||
| 65 | you can set the filemode to true with | |
| 66 | ||
| 67 | ------------ | |
| 68 | % git config-set core.filemode true | |
| 69 | ------------ | |
| 70 | ||
| 71 | The hypothetic proxy command entries actually have a postfix to discern | |
| 72 | to what URL they apply. Here is how to change the entry for kernel.org | |
| 73 | to "ssh". | |
| 74 | ||
| 75 | ------------ | |
| 76 | % git config-set proxy.command '"ssh" for kernel.org' 'for kernel.org$' | |
| 77 | ------------ | |
| 78 | ||
| 79 | This makes sure that only the key/value pair for kernel.org is replaced. | |
| 80 | ||
| 81 | To delete the entry for renames, do | |
| 82 | ||
| 83 | ------------ | |
| 84 | % git config-set --unset diff.renames | |
| 85 | ------------ | |
| 86 | ||
| 87 | or just | |
| 88 | ||
| 89 | ------------ | |
| 90 | % git config-set diff.renames | |
| 91 | ------------ | |
| 92 | ||
| 93 | If you want to delete an entry for a multivar (like proxy.command above), | |
| 94 | you have to provide a regex matching the value of exactly one line. | |
| 95 | ||
| 96 | ||
| 97 | Author | |
| 98 | ------ | |
| 99 | Written by Johannes Schindelin <Johannes.Schindelin@gmx.de> | |
| 100 | ||
| 101 | Documentation | |
| 102 | -------------- | |
| 103 | Documentation by Johannes Schindelin. | |
| 104 | ||
| 105 | GIT | |
| 106 | --- | |
| 107 | Part of the gitlink:git[7] suite | |
| 108 |