diff options
author | Alyssa Ross <hi@alyssa.is> | 2023-02-11 14:56:51 +0000 |
---|---|---|
committer | Alyssa Ross <hi@alyssa.is> | 2023-02-21 23:04:20 +0000 |
commit | b0e74a9f5d37d5f16372617fe8f404b24a56ddd2 (patch) | |
tree | c3b775902dee4ee7fde1c5fdf39b9a68da54b7c9 /Documentation/contributing/b4.adoc | |
parent | a96f09dfa6a247e2ba8068a348522a48b885dec3 (diff) | |
download | spectrum-b0e74a9f5d37d5f16372617fe8f404b24a56ddd2.tar spectrum-b0e74a9f5d37d5f16372617fe8f404b24a56ddd2.tar.gz spectrum-b0e74a9f5d37d5f16372617fe8f404b24a56ddd2.tar.bz2 spectrum-b0e74a9f5d37d5f16372617fe8f404b24a56ddd2.tar.lz spectrum-b0e74a9f5d37d5f16372617fe8f404b24a56ddd2.tar.xz spectrum-b0e74a9f5d37d5f16372617fe8f404b24a56ddd2.tar.zst spectrum-b0e74a9f5d37d5f16372617fe8f404b24a56ddd2.zip |
Documentation: move "Working with Patches" under "Contributing"
This is all information about how to contribute to Spectrum, so I think it makes more sense here than under "Development". Signed-off-by: Alyssa Ross <hi@alyssa.is> Message-Id: <20230211145650.740649-1-hi@alyssa.is>
Diffstat (limited to 'Documentation/contributing/b4.adoc')
-rw-r--r-- | Documentation/contributing/b4.adoc | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/Documentation/contributing/b4.adoc b/Documentation/contributing/b4.adoc new file mode 100644 index 0000000..b41dc58 --- /dev/null +++ b/Documentation/contributing/b4.adoc @@ -0,0 +1,51 @@ += Installing and Configuring b4 +:page-parent: Working with Patches +:page-grand_parent: Contributing +:page-nav_order: 1 + +// 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 + +https://git.kernel.org/pub/scm/utils/b4/b4.git/about/[b4] is a utility +for working with patches sent to a mailing list, such as +https://spectrum-os.org/participating.html#spectrum-devel[devel@spectrum-os.org]. + +NOTE: If you run `nix-shell` in the root of the Spectrum source tree, +you'll be dropped into a development shell that has b4 set up +correctly, and you don't need to do anything else. You only need to +configure it manually as described here if you want it to work outside +of the Spectrum root's nix-shell. + +== Installing b4 + +You should be able to install b4 from your package manager. + +Using Nix, you can start a shell with b4 available by running: + +[listing] +[source,shell] +nix-shell -p b4 + +== Configuring b4 + +As b4 was originally written for Linux development, it will default to +searching for patches on the Linux mailing lists. So to use it for +Spectrum, it needs to be configured to search the Spectrum mailing +lists instead. + +To do this, 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: + +[listing] +[source,shell] +git config b4.midmask https://spectrum-os.org/lists/archives/spectrum-devel/%s + +From now on, any b4 command run in Spectrum repositories will search +the Spectrum devel mailing list. + +== Using b4 + +Using b4 to fetch and apply a patch from the Spectrum mailing list is +described in the xref:testing-patches.adoc[Testing Patches] how-to guide. |