[PATCH master 1/2] Documentation: user: intro: update feedback section on ML
Ahmad Fatoum
a.fatoum at pengutronix.de
Thu Mar 20 01:24:25 PDT 2025
Now that kernel.org also mirrors barebox, we don't require the midmask,
linkmask configuration we had before.
Adapt the docs accordingly and explain shazam -H a bit.
Signed-off-by: Ahmad Fatoum <a.fatoum at pengutronix.de>
---
Documentation/user/introduction.rst | 21 +++++++++++++--------
1 file changed, 13 insertions(+), 8 deletions(-)
diff --git a/Documentation/user/introduction.rst b/Documentation/user/introduction.rst
index d68b57e50333..7cd289d73e39 100644
--- a/Documentation/user/introduction.rst
+++ b/Documentation/user/introduction.rst
@@ -22,26 +22,31 @@ Feedback
For sending patches, asking for help and giving general feedback you are
always welcome to write an e-mail to the barebox mailing list at
-<mailto:barebox at lists.infradead.org>. Most of the
-discussion of barebox takes place here:
+`barebox at lists.infradead.org <mailto:barebox at lists.infradead.org>`_.
+Most of the discussion of barebox takes place here:
http://lists.infradead.org/mailman/listinfo/barebox/
Mails sent to the barebox mailing list are archived on
-`lore.barebox.org <https://lore.barebox.org/barebox/>`_.
+`lore.barebox.org <https://lore.barebox.org/barebox/>`_ and
+`lore.kernel.org <https://lore.kernel.org/barebox/>`_.
barebox uses a similar patch process as the Linux kernel, so most of the
`Linux guide for submitting patches <https://www.kernel.org/doc/html/latest/process/submitting-patches.html>`_
-also applies to barebox, except forthe need to select your recipient;
+also applies to barebox, except for the need to select your recipient;
all barebox patches go to the same list.
-Patch series sent there can be applied with `b4 <https://pypi.org/project/b4/>`_ ::
+Patch series can be sent and fetched from the list using `b4 <https://pypi.org/project/b4/>`_ ::
- git config b4.midmask https://lore.barebox.org/%s
- git config b4.linkmask https://lore.barebox.org/%s
b4 shazam -M https://lore.barebox.org/$messageid # replace with link
-CI tests are executed by Github Actions an be used by forking
+Fixes should apply on master and new features on the next branch.
+If a series fails to apply, ``b4`` can determine/guess the base
+and have ``FETCH_HEAD`` point at it::
+
+ b4 shazam -H https://lore.kernel.org/$messageid # URL can be omitted
+
+CI tests are executed by Github Actions can be used by forking
`the project on Github <https://github.com/barebox/barebox>`.
There's also an IRC channel: #barebox on Libera Chat
--
2.39.5
More information about the barebox
mailing list