Re: [PATCH v1] docs: verify/bisect: fixes, finetuning, and support for Arch

[Linux regression tracking (Thorsten Leemhuis)]

On 06.03.24 14:27, Bagas Sanjaya wrote:
> On Wed, Mar 06, 2024 at 10:21:12AM +0100, Thorsten Leemhuis wrote:
>> diff --git a/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst b/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst
>> index 54bde8bac95c67..58211840ac6ffb 100644
>> --- a/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst
>> +++ b/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst
>> @@ -192,8 +192,8 @@ will be considered the 'good' release and used to prepare the .config file.
>>  
>>         sudo rm -rf /lib/modules/6.0-rc1-local-gcafec0cacaca0
>>         sudo kernel-install -v remove 6.0-rc1-local-gcafec0cacaca0
>> -       # * Note, if kernel-install is missing, you will have to
>> -       #   manually remove the kernel image and related files.
>> +       # * Note, on some distributions kernel-install is missing
>> +       #   or does only part of the job.
> 
> Consult documentation of your distribution for how to manually install/remove
> the kernel.

That would sent the wrong message in the TLDR, as the step-by-step guide
and the reference section would be the first place to look for details,
which is kinda implicit for a TLDR.

That being said: that made me look closer at the install section of the
guide and the reference section. I think they should mention "consult
documentation of your distribution" more clearly. I just looked into
this, but that requires a few bigger changes, so I'll take care of that
in a later patch I hope to send in the next few days.

>>  Install build requirements
>>  --------------------------
>> @@ -1076,72 +1078,103 @@ about to build.
>>  Here are a few examples what you typically need on some mainstream
>>  distributions:
>>  
>> +* Arch Linux and derivatives::
>> +
>> +    sudo pacman --needed -S bc binutils bison flex gcc git kmod libelf openssl \
>> +      pahole perl zlib ncurses qt6-base
>> +
>>  * Debian, Ubuntu, and derivatives::
>>  
>> -    sudo apt install bc binutils bison dwarves flex gcc git make openssl \
>> -      pahole perl-base libssl-dev libelf-dev
>> +    sudo apt install bc binutils bison dwarves flex gcc git kmod libelf-dev \
>> +      libssl-dev make openssl pahole perl-base pkg-config zlib1g-dev \
>> +      libncurses-dev qt6-base-dev g++
>>  
>>  * Fedora and derivatives::
>>  
>> -    sudo dnf install binutils /usr/include/{libelf.h,openssl/pkcs7.h} \
>> -      /usr/bin/{bc,bison,flex,gcc,git,openssl,make,perl,pahole}
>> +    sudo dnf install binutils \
>> +      /usr/bin/{bc,bison,flex,gcc,git,openssl,make,perl,pahole,rpmbuild} \
>> +      /usr/include/{libelf.h,openssl/pkcs7.h,zlib.h,ncurses.h,qt6/QtGui/QAction}
> 
> IMO qt packages are for people who wish to do xconfig instead of menuconfig
> or nconfig.

Well, yes, that's why the patch also added a few lines to point this out
and mention that installing the qt dev headers is optional. Guess you
just missed that.

Ciao, Thorsten