diff mbox series

[v4] doc: fix the max number of git show-branches shown

Message ID pull.1757.v4.git.1720319311301.gitgitgadget@gmail.com (mailing list archive)
State Superseded
Headers show
Series [v4] doc: fix the max number of git show-branches shown | expand

Commit Message

Rikita Ishikawa July 7, 2024, 2:28 a.m. UTC
From: Rikita Ishikawa <lagrange.resolvent@gmail.com>

The number to be displayed is calculated by the
following defined in object.h.

```
  #define REV_SHIFT        2
  #define MAX_REVS        (FLAG_BITS - REV_SHIFT)
```

FLAG_BITS is currently 28, so 26 is the correct
number.

Signed-off-by: Rikita Ishikawa <lagrange.resolvent@gmail.com>
---
    doc: fix the max number of git show-branches shown
    
    Changes since v1:
    
     * Explain in the commit message why "26" is the correct number.
     * No change (to rename GitHub and re-send).
     * Change the author of the commit.

Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-1757%2Fwonda-tea-coffee%2Fupdate-git-show-branch-description-v4
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-1757/wonda-tea-coffee/update-git-show-branch-description-v4
Pull-Request: https://github.com/gitgitgadget/git/pull/1757

Range-diff vs v3:

 1:  c1e236d843c ! 1:  76ab2f17015 doc: fix the max number of git show-branches shown
     @@
       ## Metadata ##
     -Author: wonda-tea-coffee <lagrange.resolvent@gmail.com>
     +Author: Rikita Ishikawa <lagrange.resolvent@gmail.com>
      
       ## Commit message ##
          doc: fix the max number of git show-branches shown


 Documentation/git-show-branch.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)


base-commit: 06e570c0dfb2a2deb64d217db78e2ec21672f558

Comments

Rikita Ishikawa July 7, 2024, 2:30 a.m. UTC | #1
Sorry for sending in consecutive messages.
I changed `From:`.
Thank you for following us often.

2024年7月7日(日) 11:28 Rikita Ishikawa via GitGitGadget <gitgitgadget@gmail.com>:
>
> From: Rikita Ishikawa <lagrange.resolvent@gmail.com>
>
> The number to be displayed is calculated by the
> following defined in object.h.
>
> ```
>   #define REV_SHIFT        2
>   #define MAX_REVS        (FLAG_BITS - REV_SHIFT)
> ```
>
> FLAG_BITS is currently 28, so 26 is the correct
> number.
>
> Signed-off-by: Rikita Ishikawa <lagrange.resolvent@gmail.com>
> ---
>     doc: fix the max number of git show-branches shown
>
>     Changes since v1:
>
>      * Explain in the commit message why "26" is the correct number.
>      * No change (to rename GitHub and re-send).
>      * Change the author of the commit.
>
> Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-1757%2Fwonda-tea-coffee%2Fupdate-git-show-branch-description-v4
> Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-1757/wonda-tea-coffee/update-git-show-branch-description-v4
> Pull-Request: https://github.com/gitgitgadget/git/pull/1757
>
> Range-diff vs v3:
>
>  1:  c1e236d843c ! 1:  76ab2f17015 doc: fix the max number of git show-branches shown
>      @@
>        ## Metadata ##
>      -Author: wonda-tea-coffee <lagrange.resolvent@gmail.com>
>      +Author: Rikita Ishikawa <lagrange.resolvent@gmail.com>
>
>        ## Commit message ##
>           doc: fix the max number of git show-branches shown
>
>
>  Documentation/git-show-branch.txt | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt
> index c771c897707..bc31d8b6d33 100644
> --- a/Documentation/git-show-branch.txt
> +++ b/Documentation/git-show-branch.txt
> @@ -22,7 +22,7 @@ Shows the commit ancestry graph starting from the commits named
>  with <rev>s or <glob>s (or all refs under refs/heads
>  and/or refs/tags) semi-visually.
>
> -It cannot show more than 29 branches and commits at a time.
> +It cannot show more than 26 branches and commits at a time.
>
>  It uses `showbranch.default` multi-valued configuration items if
>  no <rev> or <glob> is given on the command line.
>
> base-commit: 06e570c0dfb2a2deb64d217db78e2ec21672f558
> --
> gitgitgadget
Jeff King July 8, 2024, 8:52 a.m. UTC | #2
On Sun, Jul 07, 2024 at 02:28:31AM +0000, Rikita Ishikawa via GitGitGadget wrote:

> From: Rikita Ishikawa <lagrange.resolvent@gmail.com>
> 
> The number to be displayed is calculated by the
> following defined in object.h.
> 
> ```
>   #define REV_SHIFT        2
>   #define MAX_REVS        (FLAG_BITS - REV_SHIFT)
> ```
> 
> FLAG_BITS is currently 28, so 26 is the correct
> number.
> 
> Signed-off-by: Rikita Ishikawa <lagrange.resolvent@gmail.com>
> ---

Thanks, this version looks pretty good to me.

One minor nit: commit messages are not actually markdown (even when
rendered on GitHub), so your ``` block delimiters are a bit unusual.
We'd usually just rely on the indentation and blank lines to show the
structure.

-Peff
Rikita Ishikawa July 8, 2024, 1:01 p.m. UTC | #3
Thanks for the feedback.
I will fix it.
diff mbox series

Patch

diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt
index c771c897707..bc31d8b6d33 100644
--- a/Documentation/git-show-branch.txt
+++ b/Documentation/git-show-branch.txt
@@ -22,7 +22,7 @@  Shows the commit ancestry graph starting from the commits named
 with <rev>s or <glob>s (or all refs under refs/heads
 and/or refs/tags) semi-visually.
 
-It cannot show more than 29 branches and commits at a time.
+It cannot show more than 26 branches and commits at a time.
 
 It uses `showbranch.default` multi-valued configuration items if
 no <rev> or <glob> is given on the command line.