Subject: Re: [PATCH] scripts: kernel-doc: transform documentation into POD
To:     Jonathan Corbet <corbet@lwn.net>
Cc:     linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
References: <20211209225549.69010-1-tomasz.warniello@gmail.com>
 <87h7b8cfg0.fsf@meer.lwn.net>
From:   =?UTF-8?B?VG9tYXN6IFdhcm5pZcWCxYJv?= <tomasz.warniello@gmail.com>
Message-ID: <0796a780-f5ee-0b6c-e7ef-544ba5f6a429@gmail.com>
Date:   Mon, 3 Jan 2022 05:18:51 +0100
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101
 Thunderbird/78.14.0
MIME-Version: 1.0
In-Reply-To: <87h7b8cfg0.fsf@meer.lwn.net>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Precedence: bulk

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.

I will address the other topics in a new version. To be sent shortly.

Tx, TW