Re: [PATCH] scripts: kernel-doc: transform documentation into POD

From: Jani Nikula
Date: Mon Jan 03 2022 - 04:05:03 EST


On Mon, 03 Jan 2022, Tomasz Warniełło <tomasz.warniello@xxxxxxxxx> wrote:
> On 17/12/2021 00:12, Jonathan Corbet wrote:
>>> my $kernelversion;
>>> @@ -468,7 +306,7 @@ while ($ARGV[0] =~ m/^--?(.*)/) {
>>> } elsif ($cmd eq "Werror") {
>>> $Werror = 1;
>>> } elsif (($cmd eq "h") || ($cmd eq "help")) {
>>> - usage();
>>> + pod2usage(-exitval => 0, -verbose => 2);
>>
>> Why the strange indentation here? This file is far from pretty, but
>> that makes it worse. (Other places too).
>
> Sometimes beauty requires cooperation. You can help it in your pager.
> If it's less, then try `-x 2`, `-x 4`, etc.

In kernel, tabs are 8 characters.

See Documentation/process/coding-style.rst


BR,
Jani.


--
Jani Nikula, Intel Open Source Graphics Center