{"thread":{"id":"62761","subject":"[PATCH] RelNotes/2.48.0: fix typos etc.","startedAt":"2025-01-07T17:37:27Z","lastAt":"2025-01-07T18:42:55Z","messageCount":2,"participants":["kristofferhaugsbakk@fastmail.com","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"510102","messageId":"04fee3b38052ffb731e2935cd5e8ee06f3d1c69a.1736271065.git.code@khaugsbakk.name","threadId":"62761","inReplyTo":null,"subject":"[PATCH] RelNotes/2.48.0: fix typos etc.","fromName":"","fromEmail":"kristofferhaugsbakk@fastmail.com","sentAt":"2025-01-07T17:37:06Z","receivedAt":"2025-01-07T17:37:27Z","isPatch":true,"sender":{"key":"kristofferhaugsbakk@fastmail.com","avatar":null},"body":"From: Kristoffer Haugsbakk <code@khaugsbakk.name>\n\nCorrect verb tense, add missing words, avoid double blank lines,\nand rephrase things that don’t read well to me like “Turn this linkage\nto relative paths”.\n\nSigned-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>\n---\n Documentation/RelNotes/2.48.0.txt | 25 ++++++++++++-------------\n 1 file changed, 12 insertions(+), 13 deletions(-)\n\ndiff --git a/Documentation/RelNotes/2.48.0.txt b/Documentation/RelNotes/2.48.0.txt\nindex d62c62dc17a..eff93be37a2 100644\n--- a/Documentation/RelNotes/2.48.0.txt\n+++ b/Documentation/RelNotes/2.48.0.txt\n@@ -47,15 +47,15 @@ Performance, Internal Implementation, Development Support etc.\n \n  * The way AsciiDoc is used for SYNOPSIS part of the manual pages has\n    been revamped.  The sources, at least for the simple cases, got\n-   vastly pleasant to work with.\n+   vastly more pleasant to work with.\n \n  * The reftable library is now prepared to expect that the memory\n    allocation function given to it may fail to allocate and to deal\n    with such an error.\n \n  * An extra worktree attached to a repository points at each other to\n-   allow finding the repository from the worktree and vice versa\n-   possible.  Turn this linkage to relative paths.\n+   allow finding the repository from the worktree (and vice versa)\n+   possible.  Use relative paths for this linkage.\n \n  * Enable Windows-based CI in GitLab.\n \n@@ -94,7 +94,7 @@ Performance, Internal Implementation, Development Support etc.\n  * Update the project's CodingGuidelines to discourage naming functions\n    with a \"_1()\" suffix.\n \n- * Updates the '.clang-format' to match project conventions.\n+ * Update '.clang-format' to match project conventions.\n \n  * Centralize documentation for repository extensions into a single place.\n \n@@ -116,7 +116,7 @@ Performance, Internal Implementation, Development Support etc.\n  * The migration procedure between two ref backends has been optimized.\n \n  * \"git fsck\" learned to issue warnings on \"curiously formatted\" ref\n-   contents that have always been taken valid but something Git\n+   contents that have always been treated as valid but that Git\n    wouldn't have written itself (e.g., missing terminating end-of-line\n    after the full object name).\n \n@@ -127,13 +127,13 @@ Performance, Internal Implementation, Development Support etc.\n \n  * Drop support for ancient environments in various CI jobs.\n \n- * Isolates the reftable subsystem from the rest of Git's codebase by\n+ * Isolate the reftable subsystem from the rest of Git's codebase by\n    using fewer pieces of Git's infrastructure.\n \n  * Optimize reading random references out of the reftable backend by\n    allowing reuse of iterator objects.\n \n- * Backport oss-fuzz tests for us to our codebase.\n+ * Backport oss-fuzz tests to our codebase.\n \n  * Introduce a new repository extension to prevent older Git versions\n    from mis-interpreting worktrees created with relative paths.\n@@ -173,13 +173,13 @@ Fixes since v2.47\n -----------------\n \n  * Doc update to clarify how periodical maintenance are scheduled,\n-   spread across time to avoid thundering hurds.\n+   spread across time to avoid thundering herds.\n \n  * Use after free and double freeing at the end in \"git log -L... -p\"\n    had been identified and fixed.\n \n  * On macOS, fsmonitor can fall into a race condition that results in\n-   a client waiting forever to be notified for an event that have\n+   a client waiting forever to be notified about an event that has\n    already happened.  This problem has been corrected.\n \n  * \"git maintenance start\" crashed due to an uninitialized variable\n@@ -203,7 +203,7 @@ Fixes since v2.47\n  * The dumb-http code regressed when the result of re-indexing a pack\n    yielded an *.idx file that differs in content from the *.idx file\n    it downloaded from the remote. This has been corrected by no longer\n-   relying on: the *.idx file we got from the remote.\n+   relying on the *.idx file we got from the remote.\n \n  * When called with '--left-right' and '--use-bitmap-index', 'rev-list'\n    will produce output without any left/right markers, which has been\n@@ -227,7 +227,7 @@ Fixes since v2.47\n  * \"git gc\" discards any objects that are outside promisor packs that\n    are referred to by an object in a promisor pack, and we do not\n    refetch them from the promisor at runtime, resulting an unusable\n-   repository.  Work it around by including these objects in the\n+   repository.  Work around it by including these objects in the\n    referring promisor pack at the receiving end of the fetch.\n \n  * Avoid build/test breakage on a system without working malloc debug\n@@ -282,9 +282,8 @@ Fixes since v2.47\n    on the path, which was not documented, which has been corrected.\n    (merge bc1a980759 kk/doc-ancestry-path later to maint).\n \n-\n  * \"git tag\" has been taught to refuse to create refs/tags/HEAD\n-   as such a tag will be confusing in the context of UI provided by\n+   since such a tag will be confusing in the context of the UI provided by\n    the Git Porcelain commands.\n    (merge bbd445d5ef jc/forbid-head-as-tagname later to maint).\n \n\nbase-commit: b74ff38af58464688b211140b90ec90598d340c6\n-- \n2.48.0.rc2\n\n"},{"id":"510106","messageId":"xmqqr05esbwz.fsf@gitster.g","threadId":"62761","inReplyTo":"04fee3b38052ffb731e2935cd5e8ee06f3d1c69a.1736271065.git.code@khaugsbakk.name","subject":"Re: [PATCH] RelNotes/2.48.0: fix typos etc.","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2025-01-07T18:42:52Z","receivedAt":"2025-01-07T18:42:55Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"kristofferhaugsbakk@fastmail.com writes:\n\n> From: Kristoffer Haugsbakk <code@khaugsbakk.name>\n>\n> Correct verb tense, add missing words, avoid double blank lines,\n> and rephrase things that don’t read well to me like “Turn this linkage\n> to relative paths”.\n>\n> Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>\n> ---\n>  Documentation/RelNotes/2.48.0.txt | 25 ++++++++++++-------------\n>  1 file changed, 12 insertions(+), 13 deletions(-)\n\nThanks.  Will apply.\n\n>\n> diff --git a/Documentation/RelNotes/2.48.0.txt b/Documentation/RelNotes/2.48.0.txt\n> index d62c62dc17a..eff93be37a2 100644\n> --- a/Documentation/RelNotes/2.48.0.txt\n> +++ b/Documentation/RelNotes/2.48.0.txt\n> @@ -47,15 +47,15 @@ Performance, Internal Implementation, Development Support etc.\n>  \n>   * The way AsciiDoc is used for SYNOPSIS part of the manual pages has\n>     been revamped.  The sources, at least for the simple cases, got\n> -   vastly pleasant to work with.\n> +   vastly more pleasant to work with.\n>  \n>   * The reftable library is now prepared to expect that the memory\n>     allocation function given to it may fail to allocate and to deal\n>     with such an error.\n>  \n>   * An extra worktree attached to a repository points at each other to\n> -   allow finding the repository from the worktree and vice versa\n> -   possible.  Turn this linkage to relative paths.\n> +   allow finding the repository from the worktree (and vice versa)\n> +   possible.  Use relative paths for this linkage.\n>  \n>   * Enable Windows-based CI in GitLab.\n>  \n> @@ -94,7 +94,7 @@ Performance, Internal Implementation, Development Support etc.\n>   * Update the project's CodingGuidelines to discourage naming functions\n>     with a \"_1()\" suffix.\n>  \n> - * Updates the '.clang-format' to match project conventions.\n> + * Update '.clang-format' to match project conventions.\n>  \n>   * Centralize documentation for repository extensions into a single place.\n>  \n> @@ -116,7 +116,7 @@ Performance, Internal Implementation, Development Support etc.\n>   * The migration procedure between two ref backends has been optimized.\n>  \n>   * \"git fsck\" learned to issue warnings on \"curiously formatted\" ref\n> -   contents that have always been taken valid but something Git\n> +   contents that have always been treated as valid but that Git\n>     wouldn't have written itself (e.g., missing terminating end-of-line\n>     after the full object name).\n>  \n> @@ -127,13 +127,13 @@ Performance, Internal Implementation, Development Support etc.\n>  \n>   * Drop support for ancient environments in various CI jobs.\n>  \n> - * Isolates the reftable subsystem from the rest of Git's codebase by\n> + * Isolate the reftable subsystem from the rest of Git's codebase by\n>     using fewer pieces of Git's infrastructure.\n>  \n>   * Optimize reading random references out of the reftable backend by\n>     allowing reuse of iterator objects.\n>  \n> - * Backport oss-fuzz tests for us to our codebase.\n> + * Backport oss-fuzz tests to our codebase.\n>  \n>   * Introduce a new repository extension to prevent older Git versions\n>     from mis-interpreting worktrees created with relative paths.\n> @@ -173,13 +173,13 @@ Fixes since v2.47\n>  -----------------\n>  \n>   * Doc update to clarify how periodical maintenance are scheduled,\n> -   spread across time to avoid thundering hurds.\n> +   spread across time to avoid thundering herds.\n>  \n>   * Use after free and double freeing at the end in \"git log -L... -p\"\n>     had been identified and fixed.\n>  \n>   * On macOS, fsmonitor can fall into a race condition that results in\n> -   a client waiting forever to be notified for an event that have\n> +   a client waiting forever to be notified about an event that has\n>     already happened.  This problem has been corrected.\n>  \n>   * \"git maintenance start\" crashed due to an uninitialized variable\n> @@ -203,7 +203,7 @@ Fixes since v2.47\n>   * The dumb-http code regressed when the result of re-indexing a pack\n>     yielded an *.idx file that differs in content from the *.idx file\n>     it downloaded from the remote. This has been corrected by no longer\n> -   relying on: the *.idx file we got from the remote.\n> +   relying on the *.idx file we got from the remote.\n>  \n>   * When called with '--left-right' and '--use-bitmap-index', 'rev-list'\n>     will produce output without any left/right markers, which has been\n> @@ -227,7 +227,7 @@ Fixes since v2.47\n>   * \"git gc\" discards any objects that are outside promisor packs that\n>     are referred to by an object in a promisor pack, and we do not\n>     refetch them from the promisor at runtime, resulting an unusable\n> -   repository.  Work it around by including these objects in the\n> +   repository.  Work around it by including these objects in the\n>     referring promisor pack at the receiving end of the fetch.\n>  \n>   * Avoid build/test breakage on a system without working malloc debug\n> @@ -282,9 +282,8 @@ Fixes since v2.47\n>     on the path, which was not documented, which has been corrected.\n>     (merge bc1a980759 kk/doc-ancestry-path later to maint).\n>  \n> -\n>   * \"git tag\" has been taught to refuse to create refs/tags/HEAD\n> -   as such a tag will be confusing in the context of UI provided by\n> +   since such a tag will be confusing in the context of the UI provided by\n>     the Git Porcelain commands.\n>     (merge bbd445d5ef jc/forbid-head-as-tagname later to maint).\n>  \n>\n> base-commit: b74ff38af58464688b211140b90ec90598d340c6\n"}]}