{"thread":{"id":"34542","subject":"[PATCH] config doc: quote paths, fixing tilde-interpretation","startedAt":"2013-07-26T10:42:02Z","lastAt":"2013-07-26T15:45:10Z","messageCount":2,"participants":["Ramkumar Ramachandra","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"224119","messageId":"1374835322-6452-1-git-send-email-artagnon@gmail.com","threadId":"34542","inReplyTo":null,"subject":"[PATCH] config doc: quote paths, fixing tilde-interpretation","fromName":"Ramkumar Ramachandra","fromEmail":"artagnon@gmail.com","sentAt":"2013-07-26T10:42:02Z","receivedAt":"2013-07-26T10:42:02Z","isPatch":true,"sender":{"key":"r@artagnon.com","avatar":"https://avatars.githubusercontent.com/u/37226?v=4"},"body":"The --global section of git-config(1) currently reads like:\n\n  For writing options: write to global /.gitconfig file rather than the\n                                       ^\n\t\t\t\t       start tilde\n\n  repository .git/config, write to $XDG_CONFIG_HOME/git/config file if\n  this file exists and the/.gitconfig file doesn’t.\n                          ^\n\t\t\t  end tilde\n\nInstead of tilde (~) being interpreted literally, asciidoc subscripts\nthe text between the two tildes.  To fix this problem, use backticks (`)\nto quote all the paths in the file uniformly, just like config.txt does.\n\nSigned-off-by: Ramkumar Ramachandra <artagnon@gmail.com>\n---\n Candidate for maint?\n\n Documentation/git-config.txt | 26 ++++++++++++++------------\n 1 file changed, 14 insertions(+), 12 deletions(-)\n\ndiff --git a/Documentation/git-config.txt b/Documentation/git-config.txt\nindex 34b0894..2dbe486 100644\n--- a/Documentation/git-config.txt\n+++ b/Documentation/git-config.txt\n@@ -96,29 +96,31 @@ OPTIONS\n \tnames are not.\n \n --global::\n-\tFor writing options: write to global ~/.gitconfig file rather than\n-\tthe repository .git/config, write to $XDG_CONFIG_HOME/git/config file\n-\tif this file exists and the ~/.gitconfig file doesn't.\n+\tFor writing options: write to global `~/.gitconfig` file\n+\trather than the repository `.git/config`, write to\n+\t`$XDG_CONFIG_HOME/git/config` file if this file exists and the\n+\t`~/.gitconfig` file doesn't.\n +\n-For reading options: read only from global ~/.gitconfig and from\n-$XDG_CONFIG_HOME/git/config rather than from all available files.\n+For reading options: read only from global `~/.gitconfig` and from\n+`$XDG_CONFIG_HOME/git/config` rather than from all available files.\n +\n See also <<FILES>>.\n \n --system::\n-\tFor writing options: write to system-wide $(prefix)/etc/gitconfig\n-\trather than the repository .git/config.\n+\tFor writing options: write to system-wide\n+\t`$(prefix)/etc/gitconfig` rather than the repository\n+\t`.git/config`.\n +\n-For reading options: read only from system-wide $(prefix)/etc/gitconfig\n+For reading options: read only from system-wide `$(prefix)/etc/gitconfig`\n rather than from all available files.\n +\n See also <<FILES>>.\n \n --local::\n-\tFor writing options: write to the repository .git/config file.\n+\tFor writing options: write to the repository `.git/config` file.\n \tThis is\tthe default behavior.\n +\n-For reading options: read only from the repository .git/config rather than\n+For reading options: read only from the repository `.git/config` rather than\n from all available files.\n +\n See also <<FILES>>.\n@@ -218,9 +220,9 @@ $(prefix)/etc/gitconfig::\n \n $XDG_CONFIG_HOME/git/config::\n \tSecond user-specific configuration file. If $XDG_CONFIG_HOME is not set\n-\tor empty, $HOME/.config/git/config will be used. Any single-valued\n+\tor empty, `$HOME/.config/git/config` will be used. Any single-valued\n \tvariable set in this file will be overwritten by whatever is in\n-\t~/.gitconfig.  It is a good idea not to create this file if\n+\t`~/.gitconfig`.  It is a good idea not to create this file if\n \tyou sometimes use older versions of Git, as support for this\n \tfile was added fairly recently.\n \n-- \n1.8.3.3.820.ge3d4493.dirty\n"},{"id":"224130","messageId":"7vk3kd2um1.fsf@alter.siamese.dyndns.org","threadId":"34542","inReplyTo":"1374835322-6452-1-git-send-email-artagnon@gmail.com","subject":"Re: [PATCH] config doc: quote paths, fixing tilde-interpretation","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-07-26T15:45:10Z","receivedAt":"2013-07-26T15:45:10Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Ramkumar Ramachandra <artagnon@gmail.com> writes:\n\n> The --global section of git-config(1) currently reads like:\n>\n>   For writing options: write to global /.gitconfig file rather than the\n>                                        ^\n> \t\t\t\t       start tilde\n>\n>   repository .git/config, write to $XDG_CONFIG_HOME/git/config file if\n>   this file exists and the/.gitconfig file doesn’t.\n>                           ^\n> \t\t\t  end tilde\n>\n> Instead of tilde (~) being interpreted literally, asciidoc subscripts\n> the text between the two tildes.  To fix this problem, use backticks (`)\n> to quote all the paths in the file uniformly, just like config.txt does.\n>\n> Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>\n> ---\n>  Candidate for maint?\n\nSurely; thanks for sharp eyes.\n\n>  Documentation/git-config.txt | 26 ++++++++++++++------------\n>  1 file changed, 14 insertions(+), 12 deletions(-)\n>\n> diff --git a/Documentation/git-config.txt b/Documentation/git-config.txt\n> index 34b0894..2dbe486 100644\n> --- a/Documentation/git-config.txt\n> +++ b/Documentation/git-config.txt\n> @@ -96,29 +96,31 @@ OPTIONS\n>  \tnames are not.\n>  \n>  --global::\n> -\tFor writing options: write to global ~/.gitconfig file rather than\n> -\tthe repository .git/config, write to $XDG_CONFIG_HOME/git/config file\n> -\tif this file exists and the ~/.gitconfig file doesn't.\n> +\tFor writing options: write to global `~/.gitconfig` file\n> +\trather than the repository `.git/config`, write to\n> +\t`$XDG_CONFIG_HOME/git/config` file if this file exists and the\n> +\t`~/.gitconfig` file doesn't.\n>  +\n> -For reading options: read only from global ~/.gitconfig and from\n> -$XDG_CONFIG_HOME/git/config rather than from all available files.\n> +For reading options: read only from global `~/.gitconfig` and from\n> +`$XDG_CONFIG_HOME/git/config` rather than from all available files.\n>  +\n>  See also <<FILES>>.\n>  \n>  --system::\n> -\tFor writing options: write to system-wide $(prefix)/etc/gitconfig\n> -\trather than the repository .git/config.\n> +\tFor writing options: write to system-wide\n> +\t`$(prefix)/etc/gitconfig` rather than the repository\n> +\t`.git/config`.\n>  +\n> -For reading options: read only from system-wide $(prefix)/etc/gitconfig\n> +For reading options: read only from system-wide `$(prefix)/etc/gitconfig`\n>  rather than from all available files.\n>  +\n>  See also <<FILES>>.\n>  \n>  --local::\n> -\tFor writing options: write to the repository .git/config file.\n> +\tFor writing options: write to the repository `.git/config` file.\n>  \tThis is\tthe default behavior.\n>  +\n> -For reading options: read only from the repository .git/config rather than\n> +For reading options: read only from the repository `.git/config` rather than\n>  from all available files.\n>  +\n>  See also <<FILES>>.\n> @@ -218,9 +220,9 @@ $(prefix)/etc/gitconfig::\n>  \n>  $XDG_CONFIG_HOME/git/config::\n>  \tSecond user-specific configuration file. If $XDG_CONFIG_HOME is not set\n> -\tor empty, $HOME/.config/git/config will be used. Any single-valued\n> +\tor empty, `$HOME/.config/git/config` will be used. Any single-valued\n>  \tvariable set in this file will be overwritten by whatever is in\n> -\t~/.gitconfig.  It is a good idea not to create this file if\n> +\t`~/.gitconfig`.  It is a good idea not to create this file if\n>  \tyou sometimes use older versions of Git, as support for this\n>  \tfile was added fairly recently.\n"}]}