You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
154 lines
3.2 KiB
154 lines
3.2 KiB
git-config-set(1) |
|
=============== |
|
|
|
NAME |
|
---- |
|
git-config-set - Set options in .git/config. |
|
|
|
|
|
SYNOPSIS |
|
-------- |
|
'git-config-set' name [value [value_regex]] |
|
'git-config-set' --replace-all name [value [value_regex]] |
|
'git-config-set' --get name [value_regex] |
|
'git-config-set' --get-all name [value_regex] |
|
'git-config-set' --unset name [value_regex] |
|
'git-config-set' --unset-all name [value_regex] |
|
|
|
DESCRIPTION |
|
----------- |
|
You can query/set/replace/unset options with this command. The name is |
|
actually the section and the key separated by a dot, and the value will be |
|
escaped. |
|
|
|
If you want to set/unset an option which can occor on multiple lines, you |
|
should provide a POSIX regex for the value. |
|
|
|
This command will fail if |
|
|
|
. .git/config is invalid, |
|
. .git/config can not be written to, |
|
. no section was provided, |
|
. the section or key is invalid, |
|
. you try to unset an option which does not exist, or |
|
. you try to unset/set an option for which multiple lines match. |
|
|
|
|
|
OPTIONS |
|
------- |
|
|
|
--replace-all:: |
|
Default behaviour is to replace at most one line. This replaces |
|
all lines matching the key (and optionally the value_regex) |
|
|
|
--get:: |
|
Get the value for a given key (optionally filtered by a regex |
|
matching the value). |
|
|
|
--get-all:: |
|
Like get, but does not fail if the number of values for the key |
|
is not exactly one. |
|
|
|
--unset:: |
|
Remove the line matching the key from .git/config. |
|
|
|
--unset-all:: |
|
Remove all matching lines from .git/config. |
|
|
|
|
|
EXAMPLE |
|
------- |
|
|
|
Given a .git/config like this: |
|
|
|
# |
|
# This is the config file, and |
|
# a '#' or ';' character indicates |
|
# a comment |
|
# |
|
|
|
; core variables |
|
[core] |
|
; Don't trust file modes |
|
filemode = false |
|
|
|
; Our diff algorithm |
|
[diff] |
|
external = "/usr/local/bin/gnu-diff -u" |
|
renames = true |
|
|
|
; Proxy settings |
|
[proxy] |
|
command="ssh" for "ssh://kernel.org/" |
|
command="proxy-command" for kernel.org |
|
command="myprotocol-command" for "my://" |
|
|
|
you can set the filemode to true with |
|
|
|
------------ |
|
% git config-set core.filemode true |
|
------------ |
|
|
|
The hypothetic proxy command entries actually have a postfix to discern |
|
to what URL they apply. Here is how to change the entry for kernel.org |
|
to "ssh". |
|
|
|
------------ |
|
% git config-set proxy.command '"ssh" for kernel.org' 'for kernel.org$' |
|
------------ |
|
|
|
This makes sure that only the key/value pair for kernel.org is replaced. |
|
|
|
To delete the entry for renames, do |
|
|
|
------------ |
|
% git config-set --unset diff.renames |
|
------------ |
|
|
|
If you want to delete an entry for a multivar (like proxy.command above), |
|
you have to provide a regex matching the value of exactly one line. |
|
|
|
To query the value for a given key, do |
|
|
|
------------ |
|
% git config-set --get core.filemode |
|
------------ |
|
|
|
or |
|
|
|
------------ |
|
% git config-set core.filemode |
|
------------ |
|
|
|
or, to query a multivar: |
|
|
|
------------ |
|
% git config-set --get proxy.command "for kernel.org$" |
|
------------ |
|
|
|
If you want to know all the values for a multivar, do: |
|
|
|
------------ |
|
% git config-set --get-all proxy.command |
|
------------ |
|
|
|
If you like to live dangerous, you can replace *all* proxy.commands by a |
|
new one with |
|
|
|
------------ |
|
% git config-set --replace-all proxy.command ssh |
|
------------ |
|
|
|
|
|
Author |
|
------ |
|
Written by Johannes Schindelin <Johannes.Schindelin@gmx.de> |
|
|
|
Documentation |
|
-------------- |
|
Documentation by Johannes Schindelin. |
|
|
|
GIT |
|
--- |
|
Part of the gitlink:git[7] suite |
|
|
|
|