summary refs log tree commit diff
path: root/Documentation/testing-patches.adoc
diff options
context:
space:
mode:
authorAlyssa Ross <hi@alyssa.is>2022-09-14 08:22:22 +0000
committerAlyssa Ross <hi@alyssa.is>2022-09-14 08:24:39 +0000
commit2cc5bf637f944ec950f7a8162018f421e6671315 (patch)
tree82dca4abdcfdfe10768b48026b241598249546b0 /Documentation/testing-patches.adoc
parenteb2b4c7c89881eb622412ca2d87e9606f5940a30 (diff)
downloadspectrum-2cc5bf637f944ec950f7a8162018f421e6671315.tar
spectrum-2cc5bf637f944ec950f7a8162018f421e6671315.tar.gz
spectrum-2cc5bf637f944ec950f7a8162018f421e6671315.tar.bz2
spectrum-2cc5bf637f944ec950f7a8162018f421e6671315.tar.lz
spectrum-2cc5bf637f944ec950f7a8162018f421e6671315.tar.xz
spectrum-2cc5bf637f944ec950f7a8162018f421e6671315.tar.zst
spectrum-2cc5bf637f944ec950f7a8162018f421e6671315.zip
shell.nix: automatically configure b4
This will allow people who just want to test one patch series to skip
an annoying setup process.  To be honest, I'm not sure if it's worth
keeping the documentation about manually setting it up.  I'm worried
it'll just confuse people.  But I'm keeping it for now.  We can remove
it later.

Signed-off-by: Alyssa Ross <hi@alyssa.is>
Diffstat (limited to 'Documentation/testing-patches.adoc')
-rw-r--r--Documentation/testing-patches.adoc13
1 files changed, 8 insertions, 5 deletions
diff --git a/Documentation/testing-patches.adoc b/Documentation/testing-patches.adoc
index 8ba7804..743cd6e 100644
--- a/Documentation/testing-patches.adoc
+++ b/Documentation/testing-patches.adoc
@@ -2,6 +2,7 @@
 :page-parent: How-to Guides
 
 // SPDX-FileCopyrightText: 2022 Alyssa Ross <hi@alyssa.is>
+// SPDX-FileCopyrightText: 2022 Unikie
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
 
 Potential changes to Spectrum are posted to and discussed on the
@@ -10,18 +11,20 @@ mailing list.
 
 == Apply the patch
 
-If you haven't already, you'll first need to xref:b4.adoc[install and
-configure] https://git.kernel.org/pub/scm/utils/b4/b4.git/about/[b4].
-Then:
-
 . Find the patch series you want to test on
   https://spectrum-os.org/lists/archives/spectrum-devel/[public-inbox].
 . Navigate to the "permalink" page for any patch in the series.
 . Copy the Message-Id for the patch, as shown on the permalink page, e.g.
   \20220511092352.70E54C980@atuin.qyliss.net.
+. In a checkout of the https://spectrum-os.org/git/spectrum[Spectrum]
+  git repository, run `nix-shell` to enter a shell environment with b4
+  set up correctly for Spectrum.
++
+TIP: You can manually xref:b4.adoc[set up b4] so that it works outside
+of the Spectrum root's nix-shell, which allows you to skip this step.
 . In a checkout of the appropriate git repository
   (https://spectrum-os.org/git/spectrum[Spectrum] or
-  https://spectrum-os.org/git/nixpkgs[Spectrum Nixpkgs]), Run `b4 am`
+  https://spectrum-os.org/git/nixpkgs[Spectrum Nixpkgs]), run `b4 am`
   with the patch's Message-Id to download all the patches in the
   series into a file.
 +