Received: by 2002:a05:6a10:1a4d:0:0:0:0 with SMTP id nk13csp1503719pxb; Wed, 2 Feb 2022 06:29:15 -0800 (PST) X-Google-Smtp-Source: ABdhPJyrsOkdMQi7EBKYizRexpTU+n8BpS58ZnGjThoGI6O+xDzYdpF8M1iODy1BRedMcO/yfM3r X-Received: by 2002:a17:906:489b:: with SMTP id v27mr18982588ejq.120.1643812154697; Wed, 02 Feb 2022 06:29:14 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1643812154; cv=none; d=google.com; s=arc-20160816; b=F0kD2e3y4gnWqlUc+4scZUiH6+jmQtnTnzlx4PLm2XXaWoHkIG/ezz7skyvOLuDH4b yyjo+kndRZ+mOewNZlGee7Qz8dPl2RNumhrnOv3m/9RI98CATUC3kk7tMkuUVrNnYrPe X9v+LUK1xwQvmUPSlQbT8WmarlKCpco5vTyDWiz9vbfE/aG6tG6By8MDE9aUV8tFmKw8 ADNkcQiYJQ8W82P86kN4XWaAJUcjzT6ehqMUI4yxERnOpqNE8J1p857RQPOkGhLjpbDa kW8uXG1wYIU8gigNmFRpgpX5+FCp/HoM+aehaJzmbL3tVhlytVZVebUwRokrGTGYW7x2 E9pQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=+27bACsBddxh0iLE2XSEovpw5cBV4M3zWnn9TZBne+Q=; b=WY+CTPrUo+uwfgGL+WGmophNv60hD7uSEXLIHcqi+dAthbxJyAjGSp6homCFLlBOqh N5M8LJ57U9OEGNqbP4lI66U+7NVSTq1wdyQDhNXn4CSzQmspBD5ehStt6pRCnL3z2rKw bhjvncFvikmMDJEHIkj80vjKXRHUUJuddrK4mVJxfGWbuPizuqhktan5UaLJF4mUgZE8 lujmIoiBa4zpODWSBV0MSTyIpoWolofiejFttj3U1hC6l6s3kuo+gc1FPjIl6Jh/BP7S JI5TTgw67llmTdKTVdeQ7QeQ45tZZjpb/yK1m13dF/jcqxKVYdJZxVzt6YPrVJZNA5dM V33w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id dr14si12161268ejc.120.2022.02.02.06.28.48; Wed, 02 Feb 2022 06:29:14 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236403AbiBAK0s (ORCPT + 99 others); Tue, 1 Feb 2022 05:26:48 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54350 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235817AbiBAK0n (ORCPT ); Tue, 1 Feb 2022 05:26:43 -0500 Received: from wp530.webpack.hosteurope.de (wp530.webpack.hosteurope.de [IPv6:2a01:488:42:1000:50ed:8234::]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 547F4C06173E; Tue, 1 Feb 2022 02:26:43 -0800 (PST) Received: from ip4d144895.dynamic.kabel-deutschland.de ([77.20.72.149] helo=truhe.fritz.box); authenticated by wp530.webpack.hosteurope.de running ExIM with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) id 1nEqMz-0002pB-51; Tue, 01 Feb 2022 11:26:41 +0100 From: Thorsten Leemhuis To: linux-doc@vger.kernel.org, Linus Torvalds Cc: workflows@vger.kernel.org, Linux Kernel Mailing List , Jonathan Corbet , Randy Dunlap , regressions@lists.linux.dev, Greg Kroah-Hartman , Lukas Bulwahn Subject: [PATCH v4 3/3] docs: reporting-issues.rst: link new document about regressions Date: Tue, 1 Feb 2022 11:26:39 +0100 Message-Id: <978ad91647e93b20b7fe12c3f237f6de8f9eaca1.1643710947.git.linux@leemhuis.info> X-Mailer: git-send-email 2.31.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-bounce-key: webpack.hosteurope.de;linux@leemhuis.info;1643711203;661d3094; X-HE-SMSGID: 1nEqMz-0002pB-51 Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Make Documentation/admin-guide/reporting-issues.rst point to the newly created document about regressions (Documentation/admin-guide/regressions-users.rst). This allows to shorten a few explanations the new document describes better and in more detail. While at it move the copyright hint to the end of the file, as suggested during review of the new documents about regressions. Signed-off-by: Thorsten Leemhuis --- .../admin-guide/reporting-issues.rst | 60 +++++++++---------- 1 file changed, 29 insertions(+), 31 deletions(-) diff --git a/Documentation/admin-guide/reporting-issues.rst b/Documentation/admin-guide/reporting-issues.rst index d7ac13f789cc..3122c5a2fb66 100644 --- a/Documentation/admin-guide/reporting-issues.rst +++ b/Documentation/admin-guide/reporting-issues.rst @@ -1,14 +1,5 @@ .. SPDX-License-Identifier: (GPL-2.0+ OR CC-BY-4.0) -.. - If you want to distribute this text under CC-BY-4.0 only, please use 'The - Linux kernel developers' for author attribution and link this as source: - https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/admin-guide/reporting-issues.rst -.. - Note: Only the content of this RST file as found in the Linux kernel sources - is available under CC-BY-4.0, as versions of this text that were processed - (for example by the kernel's build system) might contain content taken from - files which use a more restrictive license. - +.. See the bottom of this file for additional redistribution information. Reporting issues ++++++++++++++++ @@ -395,19 +386,13 @@ fixed as soon as possible, hence there are 'issues of high priority' that get handled slightly differently in the reporting process. Three type of cases qualify: regressions, security issues, and really severe problems. -You deal with a 'regression' if something that worked with an older version of -the Linux kernel does not work with a newer one or somehow works worse with it. -It thus is a regression when a WiFi driver that did a fine job with Linux 5.7 -somehow misbehaves with 5.8 or doesn't work at all. It's also a regression if -an application shows erratic behavior with a newer kernel, which might happen -due to incompatible changes in the interface between the kernel and the -userland (like procfs and sysfs). Significantly reduced performance or -increased power consumption also qualify as regression. But keep in mind: the -new kernel needs to be built with a configuration that is similar to the one -from the old kernel (see below how to achieve that). That's because the kernel -developers sometimes can not avoid incompatibilities when implementing new -features; but to avoid regressions such features have to be enabled explicitly -during build time configuration. +You deal with a regression if some application or practical use case running +fine with one Linux kernel works worse or not at all with a newer version +compiled using a similar configuration. The document +'Documentation/admin-guide/regressions-users.rst' explains this in more detail. +It also provides a good deal of other information about regressions you might +want to be aware of; it for example explains how to add your issue to the list +of tracked regressions, to ensure it won't fall through the cracks. What qualifies as security issue is left to your judgment. Consider reading 'Documentation/admin-guide/security-bugs.rst' before proceeding, as it @@ -1073,10 +1058,10 @@ When dealing with regressions make sure the issue you face is really caused by the kernel and not by something else, as outlined above already. In the whole process keep in mind: an issue only qualifies as regression if the -older and the newer kernel got built with a similar configuration. The best way -to archive this: copy the configuration file (``.config``) from the old working -kernel freshly to each newer kernel version you try. Afterwards run ``make -olddefconfig`` to adjust it for the needs of the new version. +older and the newer kernel got built with a similar configuration. This can be +achieved by using ``make olddefconfig``, as explained in more detail by +Documentation/admin-guide/regressions-users.rst; that document also provides a +good deal of other information about regressions you might want to be aware of. Write and send the report @@ -1756,10 +1741,23 @@ art will lay some groundwork to improve the situation over time. .. - This text is maintained by Thorsten Leemhuis . If you - spot a typo or small mistake, feel free to let him know directly and he'll - fix it. You are free to do the same in a mostly informal way if you want - to contribute changes to the text, but for copyright reasons please CC + end-of-content +.. + This document is maintained by Thorsten Leemhuis . If + you spot a typo or small mistake, feel free to let him know directly and + he'll fix it. You are free to do the same in a mostly informal way if you + want to contribute changes to the text, but for copyright reasons please CC linux-doc@vger.kernel.org and "sign-off" your contribution as Documentation/process/submitting-patches.rst outlines in the section "Sign your work - the Developer's Certificate of Origin". +.. + This text is available under GPL-2.0+ or CC-BY-4.0, as stated at the top + of the file. If you want to distribute this text under CC-BY-4.0 only, + please use "The Linux kernel developers" for author attribution and link + this as source: + https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/admin-guide/reporting-issues.rst +.. + Note: Only the content of this RST file as found in the Linux kernel sources + is available under CC-BY-4.0, as versions of this text that were processed + (for example by the kernel's build system) might contain content taken from + files which use a more restrictive license. -- 2.31.1