{"thread":{"id":"2580","subject":"[PATCH] Add documentation for git-config-set","startedAt":"2005-11-17T21:49:19Z","lastAt":"2005-11-17T21:49:19Z","messageCount":1,"participants":["Johannes Schindelin"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"12149","messageId":"Pine.LNX.4.63.0511172249000.18285@wbgn013.biozentrum.uni-wuerzburg.de","threadId":"2580","inReplyTo":null,"subject":"[PATCH] Add documentation for git-config-set","fromName":"Johannes Schindelin","fromEmail":"johannes.schindelin@gmx.de","sentAt":"2005-11-17T21:49:19Z","receivedAt":"2005-11-17T21:49:19Z","isPatch":true,"sender":{"key":"johannes.schindelin@gmx.de","avatar":"https://avatars.githubusercontent.com/u/127790?v=4"},"body":"\nSigned-off-by: Johannes Schindelin <Johannes.Schindelin@gmx.de>\n\n---\n\n Documentation/git-config-set.txt |  108 ++++++++++++++++++++++++++++++++++++++\n Documentation/git.txt            |    3 +\n 2 files changed, 111 insertions(+), 0 deletions(-)\n create mode 100644 Documentation/git-config-set.txt\n\napplies-to: ee7303ec1f89940eeb5b565477ad903c379004fd\n51745dec61000862d5afbdf7024e7793424e7c10\ndiff --git a/Documentation/git-config-set.txt b/Documentation/git-config-set.txt\nnew file mode 100644\nindex 0000000..8e897be\n--- /dev/null\n+++ b/Documentation/git-config-set.txt\n@@ -0,0 +1,108 @@\n+git-config-set(1)\n+===============\n+\n+NAME\n+----\n+git-config-set - Set options in .git/config.\n+\n+\n+SYNOPSIS\n+--------\n+'git-config-set' ( name [value [value_regex]] | --unset name [value_regex] )\n+\n+DESCRIPTION\n+-----------\n+You can set/replace/unset options with this command. The name is actually\n+the section and the key separated by a dot, and the value will be escaped.\n+\n+If you want to set/unset an option which can occor on multiple lines, you\n+should provide a POSIX regex for the value.\n+\n+This command will fail if\n+\n+. .git/config is invalid,\n+. .git/config can not be written to,\n+. no section was provided,\n+. the section or key is invalid,\n+. you try to unset an option which does not exist, or\n+. you try to unset/set an option for which multiple lines match.\n+\n+\n+OPTIONS\n+-------\n+\n+--unset::\n+\tRemove the given option from .git/config\n+\n+\n+EXAMPLE\n+-------\n+\n+Given a .git/config like this:\n+\n+\t#\n+\t# This is the config file, and\n+\t# a '#' or ';' character indicates\n+\t# a comment\n+\t#\n+\n+\t; core variables\n+\t[core]\n+\t\t; Don't trust file modes\n+\t\tfilemode = false\n+\n+\t; Our diff algorithm\n+\t[diff]\n+\t\texternal = \"/usr/local/bin/gnu-diff -u\"\n+\t\trenames = true\n+\n+\t; Proxy settings\n+\t[proxy]\n+\t\tcommand=\"ssh\" for \"ssh://kernel.org/\"\n+\t\tcommand=\"proxy-command\" for kernel.org\n+\t\tcommand=\"myprotocol-command\" for \"my://\"\n+\n+you can set the filemode to true with\n+\n+------------\n+% git config-set core.filemode true\n+------------\n+\n+The hypothetic proxy command entries actually have a postfix to discern\n+to what URL they apply. Here is how to change the entry for kernel.org\n+to \"ssh\".\n+\n+------------\n+% git config-set proxy.command '\"ssh\" for kernel.org' 'for kernel.org$'\n+------------\n+\n+This makes sure that only the key/value pair for kernel.org is replaced.\n+\n+To delete the entry for renames, do\n+\n+------------\n+% git config-set --unset diff.renames\n+------------\n+\n+or just\n+\n+------------\n+% git config-set diff.renames\n+------------\n+\n+If you want to delete an entry for a multivar (like proxy.command above),\n+you have to provide a regex matching the value of exactly one line.\n+\n+\n+Author\n+------\n+Written by Johannes Schindelin <Johannes.Schindelin@gmx.de>\n+\n+Documentation\n+--------------\n+Documentation by Johannes Schindelin.\n+\n+GIT\n+---\n+Part of the gitlink:git[7] suite\n+\ndiff --git a/Documentation/git.txt b/Documentation/git.txt\nindex 338e5ac..694fee8 100644\n--- a/Documentation/git.txt\n+++ b/Documentation/git.txt\n@@ -84,6 +84,9 @@ gitlink:git-checkout-index[1]::\n gitlink:git-commit-tree[1]::\n \tCreates a new commit object\n \n+gitlink:git-config-set[1]::\n+\tSet options in .git/config.\n+\n gitlink:git-hash-object[1]::\n \tComputes the object ID from a file.\n \n---\n0.99.9.GIT\n"}]}