{"thread":{"id":"37278","subject":"[PATCH] lots of documentation fixes/rewordings in git-init(1)","startedAt":"2014-08-02T18:06:50Z","lastAt":"2014-08-08T17:29:20Z","messageCount":30,"participants":["Linus Arver","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"247177","messageId":"1407002817-29221-1-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":null,"subject":"[PATCH] lots of documentation fixes/rewordings in git-init(1)","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:50Z","receivedAt":"2014-08-02T18:06:50Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Hello,\n\nI noticed a typo in git-init(1), which led me to some related changes. All\nchanges are in Documentation/git-init.txt. I have cc'ed the people involved\n(thanks git-blame), just to make sure that my changes maintain technical\naccuracy.\n\nI've tested out the compiled man/html/etc. files and everything seems to look\ncorrect.\n\nThis is my first patch submission to the git project, thanks!\n\n-L\n"},{"id":"247178","messageId":"1407002817-29221-2-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH 1/7] Documentation: git-init: typographical fixes","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:51Z","receivedAt":"2014-08-02T18:06:51Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 6 +++---\n 1 file changed, 3 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex afd721e..5ed5859 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -43,7 +43,7 @@ OPTIONS\n -q::\n --quiet::\n \n-Only print error and warning messages, all other output will be suppressed.\n+Only print error and warning messages; all other output will be suppressed.\n \n --bare::\n \n@@ -97,7 +97,7 @@ is given:\n create a repo that is readable and writable to the current user and group,\n but inaccessible to others.\n \n-By default, the configuration flag receive.denyNonFastForwards is enabled\n+By default, the configuration flag 'receive.denyNonFastForwards' is enabled\n in shared repositories, so that you cannot force a non fast-forwarding push\n into it.\n \n@@ -113,7 +113,7 @@ TEMPLATE DIRECTORY\n The template directory contains files and directories that will be copied to\n the `$GIT_DIR` after it is created.\n \n-The template directory used will (in order):\n+The template directory used will be (in order):\n \n - The argument given with the `--template` option.\n \n-- \n2.0.3\n"},{"id":"247179","messageId":"1407002817-29221-3-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH 2/7] Documentation: git-init: list items facelift","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:52Z","receivedAt":"2014-08-02T18:06:52Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"No textual change.\n\nSigned-off-by: Linus Arver \n---\n Documentation/git-init.txt | 49 ++++++++++++++++++++++++++--------------------\n 1 file changed, 28 insertions(+), 21 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex 5ed5859..45501d0 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -72,30 +72,37 @@ repository. When specified, the config variable \"core.sharedRepository\" is\n set so that files and directories under `$GIT_DIR` are created with the\n requested permissions. When not specified, Git will use permissions reported\n by umask(2).\n-\n++\n The option can have the following values, defaulting to 'group' if no value\n is given:\n++\n+--\n+'umask' (or 'false')::\n+\n+Use permissions reported by umask(2). The default, when `--shared` is not\n+specified.\n+\n+'group' (or 'true')::\n \n- - 'umask' (or 'false'): Use permissions reported by umask(2). The default,\n- when `--shared` is not specified.\n-\n- - 'group' (or 'true'): Make the repository group-writable, (and g+sx, since\n- the git group may be not the primary group of all users).\n- This is used to loosen the permissions of an otherwise safe umask(2) value.\n- Note that the umask still applies to the other permission bits (e.g. if\n- umask is '0022', using 'group' will not remove read privileges from other\n- (non-group) users). See '0xxx' for how to exactly specify the repository\n- permissions.\n-\n- - 'all' (or 'world' or 'everybody'): Same as 'group', but make the repository\n- readable by all users.\n-\n- - '0xxx': '0xxx' is an octal number and each file will have mode '0xxx'.\n- '0xxx' will override users' umask(2) value (and not only loosen permissions\n- as 'group' and 'all' does). '0640' will create a repository which is\n- group-readable, but not group-writable or accessible to others. '0660' will\n- create a repo that is readable and writable to the current user and group,\n- but inaccessible to others.\n+Make the repository group-writable, (and g+sx, since the git group may be not\n+the primary group of all users). This is used to loosen the permissions of an\n+otherwise safe umask(2) value. Note that the umask still applies to the other\n+permission bits (e.g. if umask is '0022', using 'group' will not remove read\n+privileges from other (non-group) users). See '0xxx' for how to exactly specify\n+the repository permissions.\n+\n+'all' (or 'world' or 'everybody')::\n+\n+Same as 'group', but make the repository readable by all users.\n+\n+'0xxx'::\n+\n+'0xxx' is an octal number and each file will have mode '0xxx'. '0xxx' will\n+override users' umask(2) value (and not only loosen permissions as 'group' and\n+'all' does). '0640' will create a repository which is group-readable, but not\n+group-writable or accessible to others. '0660' will create a repo that is\n+readable and writable to the current user and group, but inaccessible to others.\n+--\n \n By default, the configuration flag 'receive.denyNonFastForwards' is enabled\n in shared repositories, so that you cannot force a non fast-forwarding push\n-- \n2.0.3\n"},{"id":"247180","messageId":"1407002817-29221-4-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH 3/7] Documentation: git-init: template directory: reword","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:53Z","receivedAt":"2014-08-02T18:06:53Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 14 +++++---------\n 1 file changed, 5 insertions(+), 9 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex 45501d0..f21b85b 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -113,22 +113,18 @@ line, the command is run inside the directory (possibly after creating it).\n \n --\n \n-\n TEMPLATE DIRECTORY\n ------------------\n \n The template directory contains files and directories that will be copied to\n the `$GIT_DIR` after it is created.\n \n-The template directory used will be (in order):\n-\n- - The argument given with the `--template` option.\n-\n- - The contents of the `$GIT_TEMPLATE_DIR` environment variable.\n-\n- - The `init.templatedir` configuration variable.\n+The template directory will be one of the following (in order):\n \n- - The default template directory: `/usr/share/git-core/templates`.\n+- the argument given with the `--template` option;\n+- the contents of the `$GIT_TEMPLATE_DIR` environment variable;\n+- the `init.templatedir` configuration variable; or\n+- the default template directory: `/usr/share/git-core/templates`.\n \n The default template directory includes some directory structure, some\n suggested \"exclude patterns\", and copies of sample \"hook\" files.\n-- \n2.0.3\n"},{"id":"247181","messageId":"1407002817-29221-5-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH 4/7] Documentation: git-init: --separate-git-dir: clarify","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:54Z","receivedAt":"2014-08-02T18:06:54Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 12 ++++++------\n 1 file changed, 6 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex f21b85b..bf0a7ae 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -57,12 +57,12 @@ DIRECTORY\" section below.)\n \n --separate-git-dir=::\n \n-Instead of initializing the repository where it is supposed to be,\n-place a filesytem-agnostic Git symbolic link there, pointing to the\n-specified path, and initialize a Git repository at the path. The\n-result is Git repository can be separated from working tree. If this\n-is reinitialization, the repository will be moved to the specified\n-path.\n+Separate the Git repository from your working tree. Instead of initializing the\n+repository as a directory to either `$GIT_DIR` or `./.git/`, create a text file\n+there containing the path to the actual repository. This file acts as\n+filesystem-agnostic Git symbolic link to the repository.\n++\n+If this is reinitialization, the repository will be moved to the specified path.\n \n --shared[=(false|true|umask|group|all|world|everybody|0xxx)]::\n \n-- \n2.0.3\n"},{"id":"247182","messageId":"1407002817-29221-6-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH 5/7] Documentation: git-init: reword parenthetical statements","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:55Z","receivedAt":"2014-08-02T18:06:55Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex bf0a7ae..96d6e67 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -108,8 +108,8 @@ By default, the configuration flag 'receive.denyNonFastForwards' is enabled\n in shared repositories, so that you cannot force a non fast-forwarding push\n into it.\n \n-If you name a (possibly non-existent) directory at the end of the command\n-line, the command is run inside the directory (possibly after creating it).\n+If you provide a 'directory', the command is run inside it. If this directory\n+does not exist, it will be created.\n \n --\n \n-- \n2.0.3\n"},{"id":"247183","messageId":"1407002817-29221-7-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH 6/7] Documentation: git-init: template directory: reword and cross-reference","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:56Z","receivedAt":"2014-08-02T18:06:56Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 5 ++---\n 1 file changed, 2 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex 96d6e67..b94d165 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -126,9 +126,8 @@ The template directory will be one of the following (in order):\n - the `init.templatedir` configuration variable; or\n - the default template directory: `/usr/share/git-core/templates`.\n \n-The default template directory includes some directory structure, some\n-suggested \"exclude patterns\", and copies of sample \"hook\" files.\n-The suggested patterns and hook files are all modifiable and extensible.\n+The default template directory includes some directory structure, suggested\n+\"exclude patterns\" (see linkgit:gitignore[5]), and sample hook files (see linkgit:githooks[5]).\n \n EXAMPLES\n --------\n-- \n2.0.3\n"},{"id":"247184","messageId":"1407002817-29221-8-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH 7/7] Documentation: git-init: flesh out example","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-02T18:06:57Z","receivedAt":"2014-08-02T18:06:57Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 6 ++++--\n 1 file changed, 4 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex b94d165..16e9f9c 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -138,10 +138,12 @@ Start a new Git repository for an existing code base::\n $ cd /path/to/my/codebase\n $ git init <1>\n $ git add . <2>\n+$ git commit <3>\n ----------------\n +\n-<1> prepare /path/to/my/codebase/.git directory\n-<2> add all existing file to the index\n+<1> Create a /path/to/my/codebase/.git directory.\n+<2> Add all existing files to the index.\n+<3> Create the first root-commit.\n \n GIT\n ---\n-- \n2.0.3\n"},{"id":"247297","messageId":"xmqqr40uoalz.fsf@gitster.dls.corp.google.com","threadId":"37278","inReplyTo":"1407002817-29221-2-git-send-email-linusarver@gmail.com","subject":"Re: [PATCH 1/7] Documentation: git-init: typographical fixes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-08-05T22:06:00Z","receivedAt":"2014-08-05T22:06:00Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Linus Arver writes:\n\n> Signed-off-by: Linus Arver \n> ---\n> Documentation/git-init.txt | 6 +++---\n> 1 file changed, 3 insertions(+), 3 deletions(-)\n>\n> diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> index afd721e..5ed5859 100644\n> --- a/Documentation/git-init.txt\n> +++ b/Documentation/git-init.txt\n> @@ -43,7 +43,7 @@ OPTIONS\n> -q::\n> --quiet::\n> \n> -Only print error and warning messages, all other output will be suppressed.\n> +Only print error and warning messages; all other output will be suppressed.\n\nOK.\n\n> --bare::\n> \n> @@ -97,7 +97,7 @@ is given:\n> create a repo that is readable and writable to the current user and group,\n> but inaccessible to others.\n> \n> -By default, the configuration flag receive.denyNonFastForwards is enabled\n> +By default, the configuration flag 'receive.denyNonFastForwards' is enabled\n> in shared repositories, so that you cannot force a non fast-forwarding push\n> into it.\n\nIf you are going to quote something that the user should literally\nuse, it is probably better to use `backticks` so that the quoted\ncontents will be typeset in monospaced typewriter-font.\n\n> @@ -113,7 +113,7 @@ TEMPLATE DIRECTORY\n> The template directory contains files and directories that will be copied to\n> the `$GIT_DIR` after it is created.\n> \n> -The template directory used will (in order):\n> +The template directory used will be (in order):\n> \n> - The argument given with the `--template` option.\n\nOK.\n\nThanks.\n"},{"id":"247298","messageId":"xmqqmwbioaeh.fsf@gitster.dls.corp.google.com","threadId":"37278","inReplyTo":"1407002817-29221-4-git-send-email-linusarver@gmail.com","subject":"Re: [PATCH 3/7] Documentation: git-init: template directory: reword","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-08-05T22:10:30Z","receivedAt":"2014-08-05T22:10:30Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Linus Arver writes:\n\n> Signed-off-by: Linus Arver \n> ---\n\nThis seems to reword and also reformat at the same time, but was the\nlatter change (i.e. to unindent the bulletted items and to remove\nblank lines between items) necessary?\n\n> Documentation/git-init.txt | 14 +++++---------\n> 1 file changed, 5 insertions(+), 9 deletions(-)\n>\n> diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> index 45501d0..f21b85b 100644\n> --- a/Documentation/git-init.txt\n> +++ b/Documentation/git-init.txt\n> @@ -113,22 +113,18 @@ line, the command is run inside the directory (possibly after creating it).\n> \n> --\n> \n> -\n> TEMPLATE DIRECTORY\n> ------------------\n> \n> The template directory contains files and directories that will be copied to\n> the `$GIT_DIR` after it is created.\n> \n> -The template directory used will be (in order):\n> -\n> - - The argument given with the `--template` option.\n> -\n> - - The contents of the `$GIT_TEMPLATE_DIR` environment variable.\n> -\n> - - The `init.templatedir` configuration variable.\n> +The template directory will be one of the following (in order):\n> \n> - - The default template directory: `/usr/share/git-core/templates`.\n> +- the argument given with the `--template` option;\n> +- the contents of the `$GIT_TEMPLATE_DIR` environment variable;\n> +- the `init.templatedir` configuration variable; or\n> +- the default template directory: `/usr/share/git-core/templates`.\n> \n> The default template directory includes some directory structure, some\n> suggested \"exclude patterns\", and copies of sample \"hook\" files.\n"},{"id":"247299","messageId":"xmqqiom6oabe.fsf@gitster.dls.corp.google.com","threadId":"37278","inReplyTo":"1407002817-29221-5-git-send-email-linusarver@gmail.com","subject":"Re: [PATCH 4/7] Documentation: git-init: --separate-git-dir: clarify","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-08-05T22:12:21Z","receivedAt":"2014-08-05T22:12:21Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Linus Arver writes:\n\n> Signed-off-by: Linus Arver \n> ---\n\nYou would need to work on your justification skills ;-) in the log\nmessage. What does this change \"clarify\" and in what way?\n\n> Documentation/git-init.txt | 12 ++++++------\n> 1 file changed, 6 insertions(+), 6 deletions(-)\n>\n> diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> index f21b85b..bf0a7ae 100644\n> --- a/Documentation/git-init.txt\n> +++ b/Documentation/git-init.txt\n> @@ -57,12 +57,12 @@ DIRECTORY\" section below.)\n> \n> --separate-git-dir=::\n> \n> -Instead of initializing the repository where it is supposed to be,\n> -place a filesytem-agnostic Git symbolic link there, pointing to the\n> -specified path, and initialize a Git repository at the path. The\n> -result is Git repository can be separated from working tree. If this\n> -is reinitialization, the repository will be moved to the specified\n> -path.\n> +Separate the Git repository from your working tree. Instead of initializing the\n> +repository as a directory to either `$GIT_DIR` or `./.git/`, create a text file\n> +there containing the path to the actual repository. This file acts as\n> +filesystem-agnostic Git symbolic link to the repository.\n> ++\n> +If this is reinitialization, the repository will be moved to the specified path.\n> \n> --shared[=(false|true|umask|group|all|world|everybody|0xxx)]::\n"},{"id":"247300","messageId":"xmqqegwuoa7b.fsf@gitster.dls.corp.google.com","threadId":"37278","inReplyTo":"1407002817-29221-8-git-send-email-linusarver@gmail.com","subject":"Re: [PATCH 7/7] Documentation: git-init: flesh out example","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-08-05T22:14:48Z","receivedAt":"2014-08-05T22:14:48Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Linus Arver writes:\n\n> Signed-off-by: Linus Arver \n> ---\n> Documentation/git-init.txt | 6 ++++--\n> 1 file changed, 4 insertions(+), 2 deletions(-)\n>\n> diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> index b94d165..16e9f9c 100644\n> --- a/Documentation/git-init.txt\n> +++ b/Documentation/git-init.txt\n> @@ -138,10 +138,12 @@ Start a new Git repository for an existing code base::\n> $ cd /path/to/my/codebase\n> $ git init <1>\n> $ git add . <2>\n> +$ git commit <3>\n\nI agree it is a good discipline to make the initial \"pristine\"\nimport immediately after \"git add .\" without doing anything else.\nPerhaps the description below wants to make it more explicit?\n\n> ----------------\n> +\n> -<1> prepare /path/to/my/codebase/.git directory\n> -<2> add all existing file to the index\n> +<1> Create a /path/to/my/codebase/.git directory.\n> +<2> Add all existing files to the index.\n> +<3> Create the first root-commit.\n> \n> GIT\n> ---\n"},{"id":"247307","messageId":"20140806045847.GA12559@k0","threadId":"37278","inReplyTo":"xmqqr40uoalz.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 1/7] Documentation: git-init: typographical fixes","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-06T04:58:48Z","receivedAt":"2014-08-06T04:58:48Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"On Tue, Aug 05, 2014 at 03:06:00PM -0700, Junio C Hamano wrote:\n> Linus Arver writes:\n> \n> > Signed-off-by: Linus Arver \n> > ---\n> > Documentation/git-init.txt | 6 +++---\n> > 1 file changed, 3 insertions(+), 3 deletions(-)\n> >\n> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> > index afd721e..5ed5859 100644\n> > --- a/Documentation/git-init.txt\n> > +++ b/Documentation/git-init.txt\n> > @@ -43,7 +43,7 @@ OPTIONS\n> > -q::\n> > --quiet::\n> > \n> > -Only print error and warning messages, all other output will be suppressed.\n> > +Only print error and warning messages; all other output will be suppressed.\n> \n> OK.\n> \n> > --bare::\n> > \n> > @@ -97,7 +97,7 @@ is given:\n> > create a repo that is readable and writable to the current user and group,\n> > but inaccessible to others.\n> > \n> > -By default, the configuration flag receive.denyNonFastForwards is enabled\n> > +By default, the configuration flag 'receive.denyNonFastForwards' is enabled\n> > in shared repositories, so that you cannot force a non fast-forwarding push\n> > into it.\n> \n> If you are going to quote something that the user should literally\n> use, it is probably better to use `backticks` so that the quoted\n> contents will be typeset in monospaced typewriter-font.\n\nOK, that is simple to change.\n\n> > @@ -113,7 +113,7 @@ TEMPLATE DIRECTORY\n> > The template directory contains files and directories that will be copied to\n> > the `$GIT_DIR` after it is created.\n> > \n> > -The template directory used will (in order):\n> > +The template directory used will be (in order):\n> > \n> > - The argument given with the `--template` option.\n> \n> OK.\n> \n> Thanks.\n"},{"id":"247308","messageId":"20140806051517.GB12559@k0","threadId":"37278","inReplyTo":"xmqqmwbioaeh.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 3/7] Documentation: git-init: template directory: reword","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-06T05:15:18Z","receivedAt":"2014-08-06T05:15:18Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"On Tue, Aug 05, 2014 at 03:10:30PM -0700, Junio C Hamano wrote:\n> Linus Arver writes:\n> \n> > Signed-off-by: Linus Arver \n> > ---\n> \n> This seems to reword and also reformat at the same time, but was the\n> latter change (i.e. to unindent the bulletted items and to remove\n> blank lines between items) necessary?\n\nNo, the unindenting/removal of blank lines is a non-grammar change and\nis not necessary, as it doesn't have any effect on the actual output\n(html/txt/manpage).\n\nI can either keep the same coding style with the rewording, or chop this\ninto two commits, one for the rewording and another for reformatting.\nWhich one do you suggest?\n\n> > Documentation/git-init.txt | 14 +++++---------\n> > 1 file changed, 5 insertions(+), 9 deletions(-)\n> >\n> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> > index 45501d0..f21b85b 100644\n> > --- a/Documentation/git-init.txt\n> > +++ b/Documentation/git-init.txt\n> > @@ -113,22 +113,18 @@ line, the command is run inside the directory (possibly after creating it).\n> > \n> > --\n> > \n> > -\n> > TEMPLATE DIRECTORY\n> > ------------------\n> > \n> > The template directory contains files and directories that will be copied to\n> > the `$GIT_DIR` after it is created.\n> > \n> > -The template directory used will be (in order):\n> > -\n> > - - The argument given with the `--template` option.\n> > -\n> > - - The contents of the `$GIT_TEMPLATE_DIR` environment variable.\n> > -\n> > - - The `init.templatedir` configuration variable.\n> > +The template directory will be one of the following (in order):\n> > \n> > - - The default template directory: `/usr/share/git-core/templates`.\n> > +- the argument given with the `--template` option;\n> > +- the contents of the `$GIT_TEMPLATE_DIR` environment variable;\n> > +- the `init.templatedir` configuration variable; or\n> > +- the default template directory: `/usr/share/git-core/templates`.\n> > \n> > The default template directory includes some directory structure, some\n> > suggested \"exclude patterns\", and copies of sample \"hook\" files.\n"},{"id":"247309","messageId":"20140806052129.GC12559@k0","threadId":"37278","inReplyTo":"xmqqiom6oabe.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 4/7] Documentation: git-init: --separate-git-dir: clarify","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-06T05:21:30Z","receivedAt":"2014-08-06T05:21:30Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"On Tue, Aug 05, 2014 at 03:12:21PM -0700, Junio C Hamano wrote:\n> Linus Arver writes:\n> \n> > Signed-off-by: Linus Arver \n> > ---\n> \n> You would need to work on your justification skills ;-) in the log\n> message. What does this change \"clarify\" and in what way?\n\nOops, sorry. I guess I should have written some more information in the\ncommit message, something like this:\n\n Use shorter sentences to describe what actually happens. We describe\n what the term \"Git symbolic link\" actually means.\n\n Also, we separate out the description of the behavioral change upon\n reinitialization into its own paragraph.\n\n> > Documentation/git-init.txt | 12 ++++++------\n> > 1 file changed, 6 insertions(+), 6 deletions(-)\n> >\n> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> > index f21b85b..bf0a7ae 100644\n> > --- a/Documentation/git-init.txt\n> > +++ b/Documentation/git-init.txt\n> > @@ -57,12 +57,12 @@ DIRECTORY\" section below.)\n> > \n> > --separate-git-dir=::\n> > \n> > -Instead of initializing the repository where it is supposed to be,\n> > -place a filesytem-agnostic Git symbolic link there, pointing to the\n> > -specified path, and initialize a Git repository at the path. The\n> > -result is Git repository can be separated from working tree. If this\n> > -is reinitialization, the repository will be moved to the specified\n> > -path.\n> > +Separate the Git repository from your working tree. Instead of initializing the\n> > +repository as a directory to either `$GIT_DIR` or `./.git/`, create a text file\n> > +there containing the path to the actual repository. This file acts as\n> > +filesystem-agnostic Git symbolic link to the repository.\n> > ++\n> > +If this is reinitialization, the repository will be moved to the specified path.\n> > \n> > --shared[=(false|true|umask|group|all|world|everybody|0xxx)]::\n"},{"id":"247313","messageId":"20140806053428.GD12559@k0","threadId":"37278","inReplyTo":"xmqqegwuoa7b.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 7/7] Documentation: git-init: flesh out example","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-06T05:34:29Z","receivedAt":"2014-08-06T05:34:29Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"On Tue, Aug 05, 2014 at 03:14:48PM -0700, Junio C Hamano wrote:\n> Linus Arver writes:\n> \n> > Signed-off-by: Linus Arver \n> > ---\n> > Documentation/git-init.txt | 6 ++++--\n> > 1 file changed, 4 insertions(+), 2 deletions(-)\n> >\n> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> > index b94d165..16e9f9c 100644\n> > --- a/Documentation/git-init.txt\n> > +++ b/Documentation/git-init.txt\n> > @@ -138,10 +138,12 @@ Start a new Git repository for an existing code base::\n> > $ cd /path/to/my/codebase\n> > $ git init <1>\n> > $ git add . <2>\n> > +$ git commit <3>\n> \n> I agree it is a good discipline to make the initial \"pristine\"\n> import immediately after \"git add .\" without doing anything else.\n> Perhaps the description below wants to make it more explicit?\n> \n\nI could add a comment like the following:\n\n For new repositories, creating a commit immediately after \"git add\n .\" is good practice as it will cleanly separate any preexisting work\n (done under some other VCS, for example) from any new work done with\n git.\n\nDoes this make sense? I am not sure how explicit you want it to be, or\nwhether I captured what you wanted to be explained.\n\nActually, I would like to know if anything is special about the\n\"root-commit\" (I only know it is written as such, with a hyphen, because\nthat is what you get from git's output message). I am not sure if this\n\"root-commit\" idea is explained in detail in git's other documentation.\n> > ----------------\n> > +\n> > -<1> prepare /path/to/my/codebase/.git directory\n> > -<2> add all existing file to the index\n> > +<1> Create a /path/to/my/codebase/.git directory.\n> > +<2> Add all existing files to the index.\n> > +<3> Create the first root-commit.\n> > \n> > GIT\n> > ---\n"},{"id":"247342","messageId":"xmqqwqalmt42.fsf@gitster.dls.corp.google.com","threadId":"37278","inReplyTo":"20140806051517.GB12559@k0","subject":"Re: [PATCH 3/7] Documentation: git-init: template directory: reword","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-08-06T17:21:33Z","receivedAt":"2014-08-06T17:21:33Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Linus Arver writes:\n\n> No, the unindenting/removal of blank lines is a non-grammar change and\n> is not necessary, as it doesn't have any effect on the actual output\n> (html/txt/manpage).\n>\n> I can either keep the same coding style with the rewording, or chop this\n> into two commits, one for the rewording and another for reformatting.\n> Which one do you suggest?\n\nIf I were doing this change, I wouldn't touch the formatting,\nbecause I did not find that the reformatted version would be any\neasier to read or maintain compared to the original.\n\nBut I suspect that you must have thought the reformatting was a good\nthing to do for a reason, and I suspected I might have been missing\nsomething obvious to you, and that was why I asked. If there is a\ngood reason to reformat, then lets hear it in the commit log message\nof one of the two patches. Otherwise we can drop the reformatting\npart.\n\nSo my suggestion would be a patch #1 to reword, and optionally\nanother patch #2 to reformat on top, if (and only if) there is a\ngood reason to reformat.\n"},{"id":"247344","messageId":"xmqqsil9msgs.fsf@gitster.dls.corp.google.com","threadId":"37278","inReplyTo":"20140806052129.GC12559@k0","subject":"Re: [PATCH 4/7] Documentation: git-init: --separate-git-dir: clarify","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-08-06T17:35:31Z","receivedAt":"2014-08-06T17:35:31Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Linus Arver writes:\n\n> On Tue, Aug 05, 2014 at 03:12:21PM -0700, Junio C Hamano wrote:\n>> Linus Arver writes:\n>> \n>> > Signed-off-by: Linus Arver \n>> > ---\n>> \n>> You would need to work on your justification skills ;-) in the log\n>> message. What does this change \"clarify\" and in what way?\n>\n> Oops, sorry. I guess I should have written some more information in the\n> commit message, something like this:\n>\n> Use shorter sentences to describe what actually happens. We describe\n> what the term \"Git symbolic link\" actually means.\n>\n> Also, we separate out the description of the behavioral change upon\n> reinitialization into its own paragraph.\n\nSounds very sensible.\n\n>> > Documentation/git-init.txt | 12 ++++++------\n>> > 1 file changed, 6 insertions(+), 6 deletions(-)\n>> >\n>> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n>> > index f21b85b..bf0a7ae 100644\n>> > --- a/Documentation/git-init.txt\n>> > +++ b/Documentation/git-init.txt\n>> > @@ -57,12 +57,12 @@ DIRECTORY\" section below.)\n>> > \n>> > --separate-git-dir=::\n>> > \n>> > -Instead of initializing the repository where it is supposed to be,\n>> > -place a filesytem-agnostic Git symbolic link there, pointing to the\n>> > -specified path, and initialize a Git repository at the path. The\n>> > -result is Git repository can be separated from working tree. If this\n>> > -is reinitialization, the repository will be moved to the specified\n>> > -path.\n>> > +Separate the Git repository from your working tree. Instead of initializing the\n>> > +repository as a directory to either `$GIT_DIR` or `./.git/`, create a text file\n>> > +there containing the path to the actual repository. This file acts as\n>> > +filesystem-agnostic Git symbolic link to the repository.\n\nWhile I agree that it is a very good idea to state \"what it does,\nwhat it is for\" with the very first sentence of the paragraph,\n\"separate the git repository from your working tree\" does not say\nmuch more than the name of the option \"--separate-git-dir\" already\ntells the reader. And I do not offhand think of a better version\n(and obviously I didn't think of any when the current text was\nreviewed and committed). The second sentence in your version is\ndefinitely an improvement over the first and the second sentences of\nthe original (\"where it is supposed to be\" does not give any new\ninformation to those who don't know, and does not help those who\nalready know).\n\nPerhaps we can simply remove the first sentence from your version?\n\n>> > +If this is reinitialization, the repository will be moved to the specified path.\n>> > \n>> > --shared[=(false|true|umask|group|all|world|everybody|0xxx)]::\n"},{"id":"247345","messageId":"xmqqoavxms7d.fsf@gitster.dls.corp.google.com","threadId":"37278","inReplyTo":"20140806053428.GD12559@k0","subject":"Re: [PATCH 7/7] Documentation: git-init: flesh out example","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-08-06T17:41:10Z","receivedAt":"2014-08-06T17:41:10Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Linus Arver writes:\n\n> On Tue, Aug 05, 2014 at 03:14:48PM -0700, Junio C Hamano wrote:\n>> Linus Arver writes:\n>> \n>> > Signed-off-by: Linus Arver \n>> > ---\n>> > Documentation/git-init.txt | 6 ++++--\n>> > 1 file changed, 4 insertions(+), 2 deletions(-)\n>> >\n>> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n>> > index b94d165..16e9f9c 100644\n>> > --- a/Documentation/git-init.txt\n>> > +++ b/Documentation/git-init.txt\n>> > @@ -138,10 +138,12 @@ Start a new Git repository for an existing code base::\n>> > $ cd /path/to/my/codebase\n>> > $ git init <1>\n>> > $ git add . <2>\n>> > +$ git commit <3>\n>> \n>> I agree it is a good discipline to make the initial \"pristine\"\n>> import immediately after \"git add .\" without doing anything else.\n>> Perhaps the description below wants to make it more explicit?\n>> \n>\n> I could add a comment like the following:\n>\n> For new repositories, creating a commit immediately after \"git add\n> .\" is good practice as it will cleanly separate any preexisting work\n> (done under some other VCS, for example) from any new work done with\n> git.\n>\n> Does this make sense? I am not sure how explicit you want it to be, or\n> whether I captured what you wanted to be explained.\n\nI was thinking more along the lines of\n\n <3> Record the pristine state as the first commit in the history.\n\nwhich should suffice without becoming excessively verbose.\n\n> Actually, I would like to know if anything is special about the\n> \"root-commit\"...\n\nAs far as Git is concerned, they are just ordinary commits without\nany parents. A commit in Git can have zero or more parents, so from\nthat \"structural\" point of view, they are not that special.\n\nThey are considered special by users because they represent the\nbeginning of the project history.\n"},{"id":"247483","messageId":"20140808163652.GA791@k0","threadId":"37278","inReplyTo":"xmqqwqalmt42.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 3/7] Documentation: git-init: template directory: reword","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T16:36:54Z","receivedAt":"2014-08-08T16:36:54Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"On Wed, Aug 06, 2014 at 10:21:33AM -0700, Junio C Hamano wrote:\n> Linus Arver writes:\n> \n> > No, the unindenting/removal of blank lines is a non-grammar change and\n> > is not necessary, as it doesn't have any effect on the actual output\n> > (html/txt/manpage).\n> >\n> > I can either keep the same coding style with the rewording, or chop this\n> > into two commits, one for the rewording and another for reformatting.\n> > Which one do you suggest?\n> \n> If I were doing this change, I wouldn't touch the formatting,\n> because I did not find that the reformatted version would be any\n> easier to read or maintain compared to the original.\n> \n> But I suspect that you must have thought the reformatting was a good\n> thing to do for a reason, and I suspected I might have been missing\n> something obvious to you, and that was why I asked. If there is a\n> good reason to reformat, then lets hear it in the commit log message\n> of one of the two patches. Otherwise we can drop the reformatting\n> part.\n\nAnd well, considering that the rewording makes the separate items into a\nsingle sentence, I thought it would help readability to delete all the\nwhitespace.\n\nIn retrospect, I don't think this is a good enough reason to reformat.\nIt was more of a personal writing style judgment call. I am dropping the\nreformatting part.\n"},{"id":"247484","messageId":"20140808164236.GB791@k0","threadId":"37278","inReplyTo":"xmqqsil9msgs.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 4/7] Documentation: git-init: --separate-git-dir: clarify","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T16:42:37Z","receivedAt":"2014-08-08T16:42:37Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"On Wed, Aug 06, 2014 at 10:35:31AM -0700, Junio C Hamano wrote:\n> While I agree that it is a very good idea to state \"what it does,\n> what it is for\" with the very first sentence of the paragraph,\n> \"separate the git repository from your working tree\" does not say\n> much more than the name of the option \"--separate-git-dir\" already\n> tells the reader.\n\nAh, I see.\n\n> And I do not offhand think of a better version\n> (and obviously I didn't think of any when the current text was\n> reviewed and committed). The second sentence in your version is\n> definitely an improvement over the first and the second sentences of\n> the original (\"where it is supposed to be\" does not give any new\n> information to those who don't know, and does not help those who\n> already know).\n\nOK.\n\n> Perhaps we can simply remove the first sentence from your version?\n\nYes, I agree. I enjoy cutting excess verbiage.\n"},{"id":"247507","messageId":"20140808164941.GC791@k0","threadId":"37278","inReplyTo":"xmqqoavxms7d.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 7/7] Documentation: git-init: flesh out example","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T16:49:42Z","receivedAt":"2014-08-08T16:49:42Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"On Wed, Aug 06, 2014 at 10:41:10AM -0700, Junio C Hamano wrote:\n> Linus Arver writes:\n> \n> > On Tue, Aug 05, 2014 at 03:14:48PM -0700, Junio C Hamano wrote:\n> >> Linus Arver writes:\n> >> \n> >> > Signed-off-by: Linus Arver \n> >> > ---\n> >> > Documentation/git-init.txt | 6 ++++--\n> >> > 1 file changed, 4 insertions(+), 2 deletions(-)\n> >> >\n> >> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\n> >> > index b94d165..16e9f9c 100644\n> >> > --- a/Documentation/git-init.txt\n> >> > +++ b/Documentation/git-init.txt\n> >> > @@ -138,10 +138,12 @@ Start a new Git repository for an existing code base::\n> >> > $ cd /path/to/my/codebase\n> >> > $ git init <1>\n> >> > $ git add . <2>\n> >> > +$ git commit <3>\n> >> \n> >> I agree it is a good discipline to make the initial \"pristine\"\n> >> import immediately after \"git add .\" without doing anything else.\n> >> Perhaps the description below wants to make it more explicit?\n> >> \n> >\n> > I could add a comment like the following:\n> >\n> > For new repositories, creating a commit immediately after \"git add\n> > .\" is good practice as it will cleanly separate any preexisting work\n> > (done under some other VCS, for example) from any new work done with\n> > git.\n> >\n> > Does this make sense? I am not sure how explicit you want it to be, or\n> > whether I captured what you wanted to be explained.\n> \n> I was thinking more along the lines of\n> \n> <3> Record the pristine state as the first commit in the history.\n> \n> which should suffice without becoming excessively verbose.\n\nAh yes, I like the brevity.\n\n> > Actually, I would like to know if anything is special about the\n> > \"root-commit\"...\n> \n> As far as Git is concerned, they are just ordinary commits without\n> any parents. A commit in Git can have zero or more parents, so from\n> that \"structural\" point of view, they are not that special.\n> \n> They are considered special by users because they represent the\n> beginning of the project history.\n\nThank you for the insight. I won't bother adding a blurb about\n\"root-commit\" and what it means because they are not that special, as\nyou said so yourself.\n"},{"id":"247510","messageId":"1407518960-6203-1-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407002817-29221-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2] lots of documentation fixes/rewordings in git-init(1)","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:13Z","receivedAt":"2014-08-08T17:29:13Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Hello,\n\nAside from the changes stemming from the discussion, I have also separated out\nsome typographical changes from patches 3 and 7, and squashed them into patch\n1. So, those commits are cleaner now.\n"},{"id":"247511","messageId":"1407518960-6203-2-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407518960-6203-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2 1/7] Documentation: git-init: typographical fixes","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:14Z","receivedAt":"2014-08-08T17:29:14Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Use backticks when we quote something that the user should literally\nuse.\n\nSigned-off-by: Linus Arver \n---\n Documentation/git-init.txt | 11 +++++------\n 1 file changed, 5 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex afd721e..f1f920e 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -43,7 +43,7 @@ OPTIONS\n -q::\n --quiet::\n \n-Only print error and warning messages, all other output will be suppressed.\n+Only print error and warning messages; all other output will be suppressed.\n \n --bare::\n \n@@ -97,7 +97,7 @@ is given:\n create a repo that is readable and writable to the current user and group,\n but inaccessible to others.\n \n-By default, the configuration flag receive.denyNonFastForwards is enabled\n+By default, the configuration flag `receive.denyNonFastForwards` is enabled\n in shared repositories, so that you cannot force a non fast-forwarding push\n into it.\n \n@@ -106,14 +106,13 @@ line, the command is run inside the directory (possibly after creating it).\n \n --\n \n-\n TEMPLATE DIRECTORY\n ------------------\n \n The template directory contains files and directories that will be copied to\n the `$GIT_DIR` after it is created.\n \n-The template directory used will (in order):\n+The template directory used will be (in order):\n \n - The argument given with the `--template` option.\n \n@@ -138,8 +137,8 @@ $ git init <1>\n $ git add . <2>\n ----------------\n +\n-<1> prepare /path/to/my/codebase/.git directory\n-<2> add all existing file to the index\n+<1> Create a /path/to/my/codebase/.git directory.\n+<2> Add all existing files to the index.\n \n GIT\n ---\n-- \n2.0.4\n"},{"id":"247512","messageId":"1407518960-6203-3-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407518960-6203-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2 2/7] Documentation: git-init: list items facelift","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:15Z","receivedAt":"2014-08-08T17:29:15Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"No textual change.\n\nSigned-off-by: Linus Arver \n---\n Documentation/git-init.txt | 49 ++++++++++++++++++++++++++--------------------\n 1 file changed, 28 insertions(+), 21 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex f1f920e..c02ccd0 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -72,30 +72,37 @@ repository. When specified, the config variable \"core.sharedRepository\" is\n set so that files and directories under `$GIT_DIR` are created with the\n requested permissions. When not specified, Git will use permissions reported\n by umask(2).\n-\n++\n The option can have the following values, defaulting to 'group' if no value\n is given:\n++\n+--\n+'umask' (or 'false')::\n+\n+Use permissions reported by umask(2). The default, when `--shared` is not\n+specified.\n+\n+'group' (or 'true')::\n \n- - 'umask' (or 'false'): Use permissions reported by umask(2). The default,\n- when `--shared` is not specified.\n-\n- - 'group' (or 'true'): Make the repository group-writable, (and g+sx, since\n- the git group may be not the primary group of all users).\n- This is used to loosen the permissions of an otherwise safe umask(2) value.\n- Note that the umask still applies to the other permission bits (e.g. if\n- umask is '0022', using 'group' will not remove read privileges from other\n- (non-group) users). See '0xxx' for how to exactly specify the repository\n- permissions.\n-\n- - 'all' (or 'world' or 'everybody'): Same as 'group', but make the repository\n- readable by all users.\n-\n- - '0xxx': '0xxx' is an octal number and each file will have mode '0xxx'.\n- '0xxx' will override users' umask(2) value (and not only loosen permissions\n- as 'group' and 'all' does). '0640' will create a repository which is\n- group-readable, but not group-writable or accessible to others. '0660' will\n- create a repo that is readable and writable to the current user and group,\n- but inaccessible to others.\n+Make the repository group-writable, (and g+sx, since the git group may be not\n+the primary group of all users). This is used to loosen the permissions of an\n+otherwise safe umask(2) value. Note that the umask still applies to the other\n+permission bits (e.g. if umask is '0022', using 'group' will not remove read\n+privileges from other (non-group) users). See '0xxx' for how to exactly specify\n+the repository permissions.\n+\n+'all' (or 'world' or 'everybody')::\n+\n+Same as 'group', but make the repository readable by all users.\n+\n+'0xxx'::\n+\n+'0xxx' is an octal number and each file will have mode '0xxx'. '0xxx' will\n+override users' umask(2) value (and not only loosen permissions as 'group' and\n+'all' does). '0640' will create a repository which is group-readable, but not\n+group-writable or accessible to others. '0660' will create a repo that is\n+readable and writable to the current user and group, but inaccessible to others.\n+--\n \n By default, the configuration flag `receive.denyNonFastForwards` is enabled\n in shared repositories, so that you cannot force a non fast-forwarding push\n-- \n2.0.4\n"},{"id":"247517","messageId":"1407518960-6203-4-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407518960-6203-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2 3/7] Documentation: git-init: template directory: reword","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:16Z","receivedAt":"2014-08-08T17:29:16Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 10 +++++-----\n 1 file changed, 5 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex c02ccd0..6ffe721 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -119,15 +119,15 @@ TEMPLATE DIRECTORY\n The template directory contains files and directories that will be copied to\n the `$GIT_DIR` after it is created.\n \n-The template directory used will be (in order):\n+The template directory will be one of the following (in order):\n \n- - The argument given with the `--template` option.\n+ - the argument given with the `--template` option;\n \n- - The contents of the `$GIT_TEMPLATE_DIR` environment variable.\n+ - the contents of the `$GIT_TEMPLATE_DIR` environment variable;\n \n- - The `init.templatedir` configuration variable.\n+ - the `init.templatedir` configuration variable; or\n \n- - The default template directory: `/usr/share/git-core/templates`.\n+ - the default template directory: `/usr/share/git-core/templates`.\n \n The default template directory includes some directory structure, some\n suggested \"exclude patterns\", and copies of sample \"hook\" files.\n-- \n2.0.4\n"},{"id":"247514","messageId":"1407518960-6203-5-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407518960-6203-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2 4/7] Documentation: git-init: --separate-git-dir: clarify","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:17Z","receivedAt":"2014-08-08T17:29:17Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Use shorter sentences to describe what actually happens. We describe\nwhat the term \"Git symbolic link\" actually means.\n\nAlso, we separate out the description of the behavioral change upon\nreinitialization into its own paragraph.\n\nSigned-off-by: Linus Arver \n---\n Documentation/git-init.txt | 12 ++++++------\n 1 file changed, 6 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex 6ffe721..3f4e46a 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -57,12 +57,12 @@ DIRECTORY\" section below.)\n \n --separate-git-dir=::\n \n-Instead of initializing the repository where it is supposed to be,\n-place a filesytem-agnostic Git symbolic link there, pointing to the\n-specified path, and initialize a Git repository at the path. The\n-result is Git repository can be separated from working tree. If this\n-is reinitialization, the repository will be moved to the specified\n-path.\n+Instead of initializing the repository as a directory to either `$GIT_DIR` or\n+`./.git/`, create a text file there containing the path to the actual\n+repository. This file acts as filesystem-agnostic Git symbolic link to the\n+repository.\n++\n+If this is reinitialization, the repository will be moved to the specified path.\n \n --shared[=(false|true|umask|group|all|world|everybody|0xxx)]::\n \n-- \n2.0.4\n"},{"id":"247516","messageId":"1407518960-6203-6-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407518960-6203-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2 5/7] Documentation: git-init: reword parenthetical statements","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:18Z","receivedAt":"2014-08-08T17:29:18Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex 3f4e46a..21e5ad9 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -108,8 +108,8 @@ By default, the configuration flag `receive.denyNonFastForwards` is enabled\n in shared repositories, so that you cannot force a non fast-forwarding push\n into it.\n \n-If you name a (possibly non-existent) directory at the end of the command\n-line, the command is run inside the directory (possibly after creating it).\n+If you provide a 'directory', the command is run inside it. If this directory\n+does not exist, it will be created.\n \n --\n \n-- \n2.0.4\n"},{"id":"247513","messageId":"1407518960-6203-7-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407518960-6203-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2 6/7] Documentation: git-init: template directory: reword and cross-reference","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:19Z","receivedAt":"2014-08-08T17:29:19Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Signed-off-by: Linus Arver \n---\n Documentation/git-init.txt | 5 ++---\n 1 file changed, 2 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex 21e5ad9..9f2c7d8 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -129,9 +129,8 @@ The template directory will be one of the following (in order):\n \n - the default template directory: `/usr/share/git-core/templates`.\n \n-The default template directory includes some directory structure, some\n-suggested \"exclude patterns\", and copies of sample \"hook\" files.\n-The suggested patterns and hook files are all modifiable and extensible.\n+The default template directory includes some directory structure, suggested\n+\"exclude patterns\" (see linkgit:gitignore[5]), and sample hook files (see linkgit:githooks[5]).\n \n EXAMPLES\n --------\n-- \n2.0.4\n"},{"id":"247515","messageId":"1407518960-6203-8-git-send-email-linusarver@gmail.com","threadId":"37278","inReplyTo":"1407518960-6203-1-git-send-email-linusarver@gmail.com","subject":"[PATCH v2 7/7] Documentation: git-init: flesh out example","fromName":"Linus Arver","fromEmail":"linusarver@gmail.com","sentAt":"2014-08-08T17:29:20Z","receivedAt":"2014-08-08T17:29:20Z","isPatch":true,"sender":{"key":"linusarver@gmail.com","avatar":"https://avatars.githubusercontent.com/u/725613?v=4"},"body":"Add a third step `git commit` after adding files for the first time.\n\nSigned-off-by: Linus Arver \n---\n Documentation/git-init.txt | 2 ++\n 1 file changed, 2 insertions(+)\n\ndiff --git a/Documentation/git-init.txt b/Documentation/git-init.txt\nindex 9f2c7d8..369f889 100644\n--- a/Documentation/git-init.txt\n+++ b/Documentation/git-init.txt\n@@ -141,10 +141,12 @@ Start a new Git repository for an existing code base::\n $ cd /path/to/my/codebase\n $ git init <1>\n $ git add . <2>\n+$ git commit <3>\n ----------------\n +\n <1> Create a /path/to/my/codebase/.git directory.\n <2> Add all existing files to the index.\n+<3> Record the pristine state as the first commit in the history.\n \n GIT\n ---\n-- \n2.0.4\n"}]}