lkml.org 
[lkml]   [2020]   [Nov]   [12]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[RFC PATCH v2 17/26] docs: reporting-bugs: explain options if reproducing on mainline fails
    Date
    Explicitly lay out the remaining options if the user can't reproduce the
    issue with a mainline kernel. Especially send those that are interested
    in seeing it fixed in stable and longterm kernels to a section dedicated
    to it (added in a later patch), as the process would get hard to follow
    if all of it was explained here; especially as there is a back reference
    to this process for regressions that are specific to stable and longterm
    and were never present in mainline.

    Signed-off-by: Thorsten Leemhuis <linux@leemhuis.info>
    ---
    Documentation/admin-guide/reporting-bugs.rst | 17 +++++++++++++++++
    1 file changed, 17 insertions(+)

    diff --git a/Documentation/admin-guide/reporting-bugs.rst b/Documentation/admin-guide/reporting-bugs.rst
    index e9fe40a96b87..60a84f52724c 100644
    --- a/Documentation/admin-guide/reporting-bugs.rst
    +++ b/Documentation/admin-guide/reporting-bugs.rst
    @@ -803,6 +803,23 @@ eliminate the reason for it before you reporting issues that occur with it. See
    the section above for details how to do that.


    +Reproduce issue with the fresh kernel
    +-------------------------------------
    +
    + *Reproduce the issue with the kernel you just installed. If it doesn't show
    + up there, head over to the instructions for issues only happening with
    + stable and longterm kernels.*
    +
    +Check if the issue occurs with the fresh Linux kernel version you just
    +installed. If it was fixed there already, consider sticking with this version
    +line and abandoning your plan to report the issue. But keep in mind that other
    +users might still be plagued by it, as long as it's not fixed in either stable
    +and longterm version from kernel.org (and thus vendor kernels derived from
    +those). If you prefer to use one of those or just want to help their users,
    +head over to the section "Details about reporting issues only occurring in
    +older kernel version lines" below.
    +
    +
    .. ############################################################################
    .. Temporary marker added while this document is rewritten. Sections above
    .. are new and dual-licensed under GPLv2+ and CC-BY 4.0, those below are old.
    --
    2.28.0
    \
     
     \ /
      Last update: 2020-11-12 19:01    [W:4.201 / U:0.020 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site