Commit b8cfda5c authored by Thorsten Leemhuis's avatar Thorsten Leemhuis Committed by Jonathan Corbet

docs: verify/bisect: remove a level of indenting

Remove a unnecessary level of indenting in some areas of the reference
section. No text changes.
Signed-off-by: default avatarThorsten Leemhuis <linux@leemhuis.info>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
Message-ID: <01f1a407e92b92d9f8614bd34882956694bab123.1710750972.git.linux@leemhuis.info>
parent 2fa9411d
...@@ -1138,12 +1138,12 @@ Git clone of Linus' mainline repository. There is nothing more to say about ...@@ -1138,12 +1138,12 @@ Git clone of Linus' mainline repository. There is nothing more to say about
that -- but there are two alternatives ways to retrieve the sources that might that -- but there are two alternatives ways to retrieve the sources that might
work better for you: work better for you:
* If you have an unreliable internet connection, consider * If you have an unreliable internet connection, consider
:ref:`using a 'Git bundle'<sources_bundle_bisref>`. :ref:`using a 'Git bundle'<sources_bundle_bisref>`.
* If downloading the complete repository would take too long or requires too * If downloading the complete repository would take too long or requires too
much storage space, consider :ref:`using a 'shallow much storage space, consider :ref:`using a 'shallow
clone'<sources_shallow_bisref>`. clone'<sources_shallow_bisref>`.
.. _sources_bundle_bisref: .. _sources_bundle_bisref:
...@@ -1195,23 +1195,23 @@ branches as explained in the step-by-step guide. ...@@ -1195,23 +1195,23 @@ branches as explained in the step-by-step guide.
Note, shallow clones have a few peculiar characteristics: Note, shallow clones have a few peculiar characteristics:
* For bisections the history needs to be deepened a few mainline versions * For bisections the history needs to be deepened a few mainline versions
farther than it seems necessary, as explained above already. That's because farther than it seems necessary, as explained above already. That's because
Git otherwise will be unable to revert or describe most of the commits within Git otherwise will be unable to revert or describe most of the commits within
a range (say 6.1..6.2), as they are internally based on earlier kernels a range (say 6.1..6.2), as they are internally based on earlier kernels
releases (like 6.0-rc2 or 5.19-rc3). releases (like 6.0-rc2 or 5.19-rc3).
* This document in most places uses ``git fetch`` with ``--shallow-exclude=`` * This document in most places uses ``git fetch`` with ``--shallow-exclude=``
to specify the earliest version you care about (or to be precise: its git to specify the earliest version you care about (or to be precise: its git
tag). You alternatively can use the parameter ``--shallow-since=`` to specify tag). You alternatively can use the parameter ``--shallow-since=`` to specify
an absolute (say ``'2023-07-15'``) or relative (``'12 months'``) date to an absolute (say ``'2023-07-15'``) or relative (``'12 months'``) date to
define the depth of the history you want to download. When using them while define the depth of the history you want to download. When using them while
bisecting mainline, ensure to deepen the history to at least 7 months before bisecting mainline, ensure to deepen the history to at least 7 months before
the release of the mainline release your 'good' kernel is based on. the release of the mainline release your 'good' kernel is based on.
* Be warned, when deepening your clone you might encounter an error like * Be warned, when deepening your clone you might encounter an error like
'fatal: error in object: unshallow cafecaca0c0dacafecaca0c0dacafecaca0c0da'. 'fatal: error in object: unshallow cafecaca0c0dacafecaca0c0dacafecaca0c0da'.
In that case run ``git repack -d`` and try again. In that case run ``git repack -d`` and try again.
[:ref:`back to step-by-step guide <sources_bissbs>`] [:ref:`back to step-by-step guide <sources_bissbs>`]
[:ref:`back to section intro <sources_bisref>`] [:ref:`back to section intro <sources_bisref>`]
...@@ -1235,23 +1235,23 @@ locate the right build configuration.* ...@@ -1235,23 +1235,23 @@ locate the right build configuration.*
Two things can easily go wrong when creating a .config file as advised: Two things can easily go wrong when creating a .config file as advised:
* The oldconfig target will use a .config file from your build directory, if * The oldconfig target will use a .config file from your build directory, if
one is already present there (e.g. '~/linux/.config'). That's totally fine if one is already present there (e.g. '~/linux/.config'). That's totally fine if
that's what you intend (see next step), but in all other cases you want to that's what you intend (see next step), but in all other cases you want to
delete it. This for example is important in case you followed this guide delete it. This for example is important in case you followed this guide
further, but due to problems come back here to redo the configuration from further, but due to problems come back here to redo the configuration from
scratch. scratch.
* Sometimes olddefconfig is unable to locate the .config file for your running * Sometimes olddefconfig is unable to locate the .config file for your running
kernel and will use defaults, as briefly outlined in the guide. In that case kernel and will use defaults, as briefly outlined in the guide. In that case
check if your distribution ships the configuration somewhere and manually put check if your distribution ships the configuration somewhere and manually put
it in the right place (e.g. '~/linux/.config') if it does. On distributions it in the right place (e.g. '~/linux/.config') if it does. On distributions
where /proc/config.gz exists this can be achieved using this command:: where /proc/config.gz exists this can be achieved using this command::
zcat /proc/config.gz > .config zcat /proc/config.gz > .config
Once you put it there, run ``make olddefconfig`` again to adjust it to the Once you put it there, run ``make olddefconfig`` again to adjust it to the
needs of the kernel about to be built. needs of the kernel about to be built.
Note, the olddefconfig target will set any undefined build options to their Note, the olddefconfig target will set any undefined build options to their
default value. If you prefer to set such configuration options manually, use default value. If you prefer to set such configuration options manually, use
...@@ -1393,16 +1393,16 @@ when following this guide on a few commodity distributions. ...@@ -1393,16 +1393,16 @@ when following this guide on a few commodity distributions.
**Debian:** **Debian:**
* Remove a stale reference to a certificate file that would cause your build to * Remove a stale reference to a certificate file that would cause your build to
fail:: fail::
./scripts/config --set-str SYSTEM_TRUSTED_KEYS '' ./scripts/config --set-str SYSTEM_TRUSTED_KEYS ''
Alternatively, download the needed certificate and make that configuration Alternatively, download the needed certificate and make that configuration
option point to it, as `the Debian handbook explains in more detail option point to it, as `the Debian handbook explains in more detail
<https://debian-handbook.info/browse/stable/sect.kernel-compilation.html>`_ <https://debian-handbook.info/browse/stable/sect.kernel-compilation.html>`_
-- or generate your own, as explained in -- or generate your own, as explained in
Documentation/admin-guide/module-signing.rst. Documentation/admin-guide/module-signing.rst.
[:ref:`back to step-by-step guide <configmods_bissbs>`] [:ref:`back to step-by-step guide <configmods_bissbs>`]
...@@ -1563,11 +1563,11 @@ The step-by-step guide uses the default make targets (e.g. 'bzImage' and ...@@ -1563,11 +1563,11 @@ The step-by-step guide uses the default make targets (e.g. 'bzImage' and
steps of the guide then install. You instead can also directly build everything steps of the guide then install. You instead can also directly build everything
and directly package it up by using one of the following targets: and directly package it up by using one of the following targets:
* ``make -j $(nproc --all) bindeb-pkg`` to generate a deb package * ``make -j $(nproc --all) bindeb-pkg`` to generate a deb package
* ``make -j $(nproc --all) binrpm-pkg`` to generate a rpm package * ``make -j $(nproc --all) binrpm-pkg`` to generate a rpm package
* ``make -j $(nproc --all) tarbz2-pkg`` to generate a bz2 compressed tarball * ``make -j $(nproc --all) tarbz2-pkg`` to generate a bz2 compressed tarball
This is just a selection of available make targets for this purpose, see This is just a selection of available make targets for this purpose, see
``make help`` for others. You can also use these targets after running ``make help`` for others. You can also use these targets after running
...@@ -1599,20 +1599,20 @@ If installkernel is found, the kernel's build system will delegate the actual ...@@ -1599,20 +1599,20 @@ If installkernel is found, the kernel's build system will delegate the actual
installation of your kernel image to this executable, which then performs some installation of your kernel image to this executable, which then performs some
or all of these tasks: or all of these tasks:
* On almost all Linux distributions installkernel will store your kernel's * On almost all Linux distributions installkernel will store your kernel's
image in /boot/, usually as '/boot/vmlinuz-<kernelrelease_id>'; often it will image in /boot/, usually as '/boot/vmlinuz-<kernelrelease_id>'; often it will
put a 'System.map-<kernelrelease_id>' alongside it. put a 'System.map-<kernelrelease_id>' alongside it.
* On most distributions installkernel will then generate an 'initramfs' * On most distributions installkernel will then generate an 'initramfs'
(sometimes also called 'initrd'), which usually are stored as (sometimes also called 'initrd'), which usually are stored as
'/boot/initramfs-<kernelrelease_id>.img' or '/boot/initramfs-<kernelrelease_id>.img' or
'/boot/initrd-<kernelrelease_id>'. Commodity distributions rely on this file '/boot/initrd-<kernelrelease_id>'. Commodity distributions rely on this file
for booting, hence ensure to execute the make target 'modules_install' first, for booting, hence ensure to execute the make target 'modules_install' first,
as your distribution's initramfs generator otherwise will be unable to find as your distribution's initramfs generator otherwise will be unable to find
the modules that go into the image. the modules that go into the image.
* On some distributions installkernel will then add an entry for your kernel * On some distributions installkernel will then add an entry for your kernel
to your bootloader's configuration. to your bootloader's configuration.
You have to take care of some or all of the tasks yourself, if your You have to take care of some or all of the tasks yourself, if your
distribution lacks a installkernel script or does only handle part of them. distribution lacks a installkernel script or does only handle part of them.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment