From nobody Sat Sep 26 04:37:30 2026 Received: from mout-p-202.mailbox.org (mout-p-202.mailbox.org [80.241.56.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3BE81471273; Fri, 4 Sep 2026 11:48:29 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=80.241.56.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788522511; cv=none; b=Ea1GcukQw8dgm72N3HQvRx6nX8fF6n4wqQUrvrX1bh714oDUW+fdpGgnJ1bfnQx+YA0yTylwdf6E9wCemxj+VwyEKhOTINBAzyTNAZCOuIyt0fMx96/UjI8ZJOxQCElcX3huv4bEljg/AvPDjmR/Tw1+XBRgMCR380YPdLb9yCQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788522511; c=relaxed/simple; bh=ubpm0QU2OuqRx6qd+rYBKMTGJ2aBKl4TfxjigFcd0ok=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=uV51atshw7TF1NNQyxyfsN/Vs86xIdFfvgll1lhDM165vwQEyUU0Cjkq9SAqutaYYWxFUlLGFFucmFj2GsjqYkZNNTrpybcO5sU6C6WkiQorjRpngXwmL6RzPejPcuVYs1mX3izb8oN3XrG7xcExBX0rQeB14Y5lb/eR2WeXq8M= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=mailbox.org; spf=pass smtp.mailfrom=mailbox.org; dkim=pass (2048-bit key) header.d=mailbox.org header.i=@mailbox.org header.b=dx/E4xZW; dkim=pass (2048-bit key) header.d=mailbox.org header.i=@mailbox.org header.b=rm8qXpJV; arc=none smtp.client-ip=80.241.56.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=mailbox.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=mailbox.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=mailbox.org header.i=@mailbox.org header.b="dx/E4xZW"; dkim=pass (2048-bit key) header.d=mailbox.org header.i=@mailbox.org header.b="rm8qXpJV" Received: from smtp2.mailbox.org (smtp2.mailbox.org [IPv6:2001:67c:2050:b231:465::2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mout-p-202.mailbox.org (Postfix) with ESMTPS id 4hbvqZ5f0ZzMlFl; Fri, 04 Sep 2026 13:48:26 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mailbox.org; s=mail20150812; t=1788522506; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=0IDHYEhKVDYUbbOT0ywj66+UFSpUfNMBJ3PlFrCyI7I=; b=dx/E4xZW1AMkl/G9a/4wp+LUsfvaiMNpSbZwM3KKqsBscRkljfv4H5GNtOO2UL2ayOMA/R QUEtNzfn/spSiGVQZf1myb7bmX7GzS7a4zuFA60f8GzGHVFogYYREexNovBFFxmBeWCvpd yuThRyyY4ueP1G0YiBDVFnCc+Jxm/s+mU2H+jTPzYxRskauXFeDlpbY5KUMDTfCdrlNL1Q Fd8f2njoWXpnIkDK5UuoZjXI76S12Xa1BPz31UKGubI8C4y7DA9eVKrkO+jB3AuzzPLSB2 dxWen/n0fsOj6kRn77qe5nFIKlZEhNbYH8uOjysm8JpyZ023JlCGQr8VQKUkjQ== Authentication-Results: outgoing_mbo_mout; dkim=pass header.d=mailbox.org header.s=mail20150812 header.b=rm8qXpJV; spf=pass (outgoing_mbo_mout: domain of manuelebnerli@mailbox.org designates 2001:67c:2050:b231:465::2 as permitted sender) smtp.mailfrom=manuelebnerli@mailbox.org From: Manuel Ebner DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mailbox.org; s=mail20150812; t=1788522505; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=0IDHYEhKVDYUbbOT0ywj66+UFSpUfNMBJ3PlFrCyI7I=; b=rm8qXpJVNTC16zXMQSJdZ/lki5qpAbP3qerIWjCaOGl11xaO4tnYT4NEGGukpWZlI/22uD xOeaU9eJAbn6QMJoF1rPiD9k7++rmpIlm6PFUn5nwVjP2t6lrgPNnwyFL+d/vFDNyHBYGx 4g8drUcjs85vv3tSoF0Z636HGhytofTZIVw9IsBbQ0bfP35I3wdHs91DMRHwNP3jOWJwWJ txsoTEBkYHo93kuR9jbBOGQ82DbuEwSpJaYAwVYrKN+Cp45al8rrK1ceuELB2jtd/KOxTa avtYz6L9Z3VGmEjMrIlu+cDlkU81eHOdLIzjnTWNNrAxEg7Z0QYxdtrEtN12eA== To: Thorsten Leemhuis , Jonathan Corbet , Shuah Khan Cc: Manuel Ebner , Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v4] docs: verify/bisect: fix typos, formating and punctuation Date: Fri, 4 Sep 2026 13:46:07 +0200 Message-ID: <20260904114606.756700-3-manuelebnerli@mailbox.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-MBO-RS-META: mjn4nsfywahewddgbzhefzjezp4ft7oe X-MBO-RS-ID: afa7914c27117a6ceb4 X-Rspamd-Queue-Id: 4hbvqZ5f0ZzMlFl Content-Type: text/plain; charset="utf-8" Improve readability. Signed-off-by: Manuel Ebner CC: Randy Dunlap Acked-by: Thorsten Leemhuis --- [v4] - remove 'Reviewed-by: Randy Dunlap' [v3] + incorporate Thorsten's suggestions [v2] https://lore.kernel.org/all/20260902115121.687986-2-manuelebnerli@mailbox.= org/ + one more 'your' -> 'you' + 'it' + incorporate Randy's suggestions https://lore.kernel.org/all/0475c09c-e165-41a5-b654-5c6aefeaab0b@infrad= ead.org/ + Reviewed-by: Randy Dunlap (added by mistake) [v1] https://lore.kernel.org/all/20260829055501.581856-2-manuelebnerli@mailbox.= org/ --- .../verify-bugs-and-bisect-regressions.rst | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/Documentation/admin-guide/verify-bugs-and-bisect-regressions.r= st b/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst index 7d38393f3..91ebb631a 100644 --- a/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst +++ b/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst @@ -163,7 +163,7 @@ will be considered the 'good' release and used to prepa= re the .config file. section 'Complementary tasks: cleanup during and after the process' below. =20 - d) Once your finished the bisection, put a few things away:: + d) Once you have finished the bisection, put a few things away:: =20 cd ~/linux/ git bisect log > ~/bisect-log @@ -178,9 +178,9 @@ will be considered the 'good' release and used to prepa= re the .config file. ./scripts/config --set-str CONFIG_LOCALVERSION '-local-cafec0cacaca= 0-reverted' =20 This is optional, as some commits are impossible to revert. But if the - second command worked flawlessly, build, install, and boot one more ke= rnel - kernel; just this time skip the first command copying the base .config= file - over, as that already has been taken care off. + second command worked flawlessly, build, install, and boot one more ke= rnel; + just this time skip the first command copying the base .config file ov= er, + as that already has been taken care off. =20 * **Complementary tasks**: cleanup during and after the process. =20 @@ -229,10 +229,10 @@ depends on your issue: Execute all steps till the end of *segment 1* to **verify if your kernel p= roblem is present in code supported by Linux kernel developers**. If it is, you a= re all set to report the bug -- unless it did not happen with earlier kernel vers= ions, -as then your want to at least continue with *segment 2* to **check if the = issue +as then you want to at least continue with *segment 2* to **check if the i= ssue qualifies as regression** which receive priority treatment. Depending on t= he outcome you then are ready to report a bug or submit a preliminary regress= ion -report; instead of the latter your could also head straight on and follow +report; instead of the latter you could also head straight on and follow *segment 3* to **perform a bisection** for a full-fledged regression report developers are obliged to act upon. =20 @@ -550,7 +550,7 @@ be a waste of time. [:ref:`details `] cd ~/linux/ git switch --discard-changes --detach stable/linux-6.1.y =20 - Your series is unsupported, if is not listed or carrying a 'end of lif= e' + Your series is unsupported if it is not listed or it is carrying a 'en= d of life' tag. In that case you might want to check if a successor series (say linux-6.2.y) or mainline (see next point) fix the bug. =20 @@ -1183,9 +1183,9 @@ Space requirements The numbers mentioned are rough estimates with a big extra charge to be on= the safe side, so often you will need less. =20 -If you have space constraints, be sure to hay attention to the :ref:`step = about -debug symbols' ` and its :ref:`accompanying reference -section' `, as disabling then will reduce the consume= d disk +If you have space constraints, be sure to pay attention to the :ref:`step = about +debug symbols ` and its :ref:`accompanying reference +section `, as disabling them will reduce the consumed= disk space by quite a few gigabytes. =20 [:ref:`back to step-by-step guide `] @@ -1254,8 +1254,8 @@ distributions: kernel-install-tools libelf-devel make modutils openssl openssl-deve= l \ perl-base zlib-devel rpm-build ncurses-devel qt6-base-devel =20 -These commands install a few packages that are often, but not always neede= d. You -for example might want to skip installing the development headers for ncur= ses, +These commands install a few packages that are often, but not always neede= d. For +example, you might want to skip installing the development headers for ncu= rses, which you will only need in case you later might want to adjust the kernel= build configuration using make the targets 'menuconfig' or 'nconfig'; likewise o= mit the headers of Qt6 if you do not plan to adjust the .config using 'xconfig= '. @@ -1407,7 +1407,7 @@ Occasionally odd things happen when trying to use a c= onfig file prepared for one kernel (say 6.1) on an older mainline release -- especially if it is much = older (say 5.15). That's one of the reasons why the previous step in the guide t= old you to boot the kernel where everything works. If you manually add a .conf= ig -file you thus want to ensure it's from the working kernel and not from a o= ne +file you thus want to ensure it's from the working kernel and not from one that shows the regression. =20 In case you want to build kernels for another machine, locate its kernel b= uild --=20 2.54.0