From: "Martin Ågren" <martin.agren@gmail.com>
To: Jeff King <peff@peff.net>
Cc: git@vger.kernel.org, "Victoria Dye" <vdye@github.com>,
"Ævar Arnfjörð Bjarmason" <avarab@gmail.com>
Subject: Re: [PATCH] cmd-list.perl: fix identifying man sections
Date: Mon, 26 Sep 2022 09:16:25 +0200 [thread overview]
Message-ID: <CAN0heSpPGuSYb1nEyA3RuV+ACrXjHu+YqxAsfZN62EHVqcQ9Mg@mail.gmail.com> (raw)
In-Reply-To: <Yy4uDW9YjpleFUHW@coredump.intra.peff.net>
On Sat, 24 Sept 2022 at 00:07, Jeff King <peff@peff.net> wrote:
>
> I wondered if we might have caught this in a more automatic way. The
> output of:
>
> cd Documentation
> ./doc-diff cc75e556a9^ cc75e556a9
>
> makes the problem apparent, but I don't fault reviewers for not running
> it. I rarely remember to do so. And in general you need a human looking
> at doc-diff output to know if it was the intended change or not.
>
> I wondered if it might be worth running
>
> ./doc-diff v2.37.0 v2.38.0-rc1
>
> near a release to scan over all of the changes. But the diff is over
> 8000 lines, and I admit my eyes glazed over before I got to the
> problematic hunks (even though I knew I was looking for them!).
I know how you felt when you looked at that doc-diff... I was lucky
enough to first look at
./doc-diff v2.37.0 v2.38.0-rc0
so that when I then looked at
./doc-diff v2.38.0-rc0 v2.38.0-rc1
this stood out quite well.
> So I dunno. I think doc-diff is a potentially useful tool, but I'm not
> sure how to point the human attention at the right spot to find a bug.
I try to do some such doc-diffing every now and then, and in particular
around rc time. It has caught a few buglets, usually nothing major.
I've also done
./doc-diff origin/next origin/seen
at times to catch such things a lot earlier, but it's not often that I
find the time to do so / think about doing it.
> Maybe "given enough eyeballs, all bugs are shallow" is our best bet
> here. After all, it did find this bug before the release. :)
Yeah, and luck never hurts -- I think it's fair to assume that I would
have missed this bug if it hadn't come in after rc0.
Martin
next prev parent reply other threads:[~2022-09-26 7:16 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-09-23 7:03 [PATCH] cmd-list.perl: fix identifying man sections Martin Ågren
2022-09-23 7:38 ` Ævar Arnfjörð Bjarmason
2022-09-23 8:07 ` [PATCH v2] " Martin Ågren
2022-09-23 8:37 ` Ævar Arnfjörð Bjarmason
2022-09-23 11:42 ` Martin Ågren
2022-09-23 17:01 ` Junio C Hamano
2022-09-23 22:07 ` [PATCH] " Jeff King
2022-09-26 7:16 ` Martin Ågren [this message]
2022-09-26 17:06 ` Junio C Hamano
2022-09-26 13:35 ` Ævar Arnfjörð Bjarmason
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAN0heSpPGuSYb1nEyA3RuV+ACrXjHu+YqxAsfZN62EHVqcQ9Mg@mail.gmail.com \
--to=martin.agren@gmail.com \
--cc=avarab@gmail.com \
--cc=git@vger.kernel.org \
--cc=peff@peff.net \
--cc=vdye@github.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).