public inbox for bitbake-devel@lists.openembedded.org
 help / color / mirror / Atom feed
From: "Antonin Godard" <antonin.godard@bootlin.com>
To: "Alexander Kanavin" <alex.kanavin@gmail.com>,
	<richard.purdie@linuxfoundation.org>
Cc: <quentin.schulz@cherry.de>,
	<bitbake-devel@lists.openembedded.org>,
	"Thomas Petazzoni" <thomas.petazzoni@bootlin.com>,
	<docs@lists.yoctoproject.org>
Subject: Re: [bitbake-devel] [docs] [PATCH 1/2] bitbake-setup: rename "abort" rebase conflict stragegy to "halt"
Date: Fri, 03 Apr 2026 10:07:05 +0200	[thread overview]
Message-ID: <DHJD5ZA0XGWN.3LDDWNE9PDM1X@bootlin.com> (raw)
In-Reply-To: <CANNYZj9U3BYUv-cvQvmu7d=8O82Gdg-2GSon6vNJ71BMi6bKsg@mail.gmail.com>

On Tue Mar 31, 2026 at 1:36 PM CEST, Alexander Kanavin wrote:
> There’s a simpler rationale too: this follows ‘git rebase —abort’. If git
> upstream finds a better word, we will follow. And I agree that all of the
> proposed alternatives are less accurate.

This goes against previous efforts to convert the documentation and other
components to not use these words :/
https://lists.openembedded.org/g/openembedded-architecture/topic/inclusive_language_summary/75821819

[...]
>> > This is not what halt means. Maybe 'reset' would be a better choice? Or
>> > if you really want to follow the recommendations from that website, I
>> > guess "cancel"?
>>
>> The trouble is none of these alternatives really match what abort
>> means, reset and cancel do mean something different. "abandon" might be
>> closer but still isn't right. "attempt" maybe? If we get too creative
>> with this, users just won't understand what it means :(

I had the impression, from the documentation, that bitbake-setup would leave the
repository in the middle of a rebase, to let you deal with conflict, and then
continue on the next bitbake-setup update call.

It appears to use --abort instead, so a misunderstanding from my part.

Out of these options, I think "reset" might be the best one, I agree with
Quentin. But I'm not a native speaker, so I might not have an understanding as
subtle as others.

I'll let Richard decide on what to do here.

Antonin


  reply	other threads:[~2026-04-03  8:07 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-03-31  8:14 [PATCH 0/2] bitbake-setup docs fixes Antonin Godard
2026-03-31  8:14 ` [PATCH 1/2] bitbake-setup: rename "abort" rebase conflict stragegy to "halt" Antonin Godard
2026-03-31  9:00   ` [docs] " Quentin Schulz
2026-03-31 10:43     ` Richard Purdie
2026-03-31 11:36       ` [bitbake-devel] " Alexander Kanavin
2026-04-03  8:07         ` Antonin Godard [this message]
2026-04-03 10:04           ` Alexander Kanavin
2026-04-03 10:16             ` Richard Purdie
2026-03-31  8:14 ` [PATCH 2/2] doc/bitbake-user-manual-environment-setup.rst: replace shell blocks by console Antonin Godard

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

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=DHJD5ZA0XGWN.3LDDWNE9PDM1X@bootlin.com \
    --to=antonin.godard@bootlin.com \
    --cc=alex.kanavin@gmail.com \
    --cc=bitbake-devel@lists.openembedded.org \
    --cc=docs@lists.yoctoproject.org \
    --cc=quentin.schulz@cherry.de \
    --cc=richard.purdie@linuxfoundation.org \
    --cc=thomas.petazzoni@bootlin.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.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox