Re: [PATCH 1/1] docs: kerneldoc.py: don't use Sphinx logger

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Mauro,

I do appreciate your work on the document system.  Particularly you
have made the process much faster.  However, see below.

On Tue, 20 May 2025 11:19:56 +0200 Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> wrote:
>
> If by "innocent typo" you mean removing/renaming/moving a file from
> the Kernel tree without updating Makefiles, or adding them with wrong
> names, then yes: I do think this should be fatal for the affected "make" 
> targets. The quickest such build issues are caught, the best for everyone.

They are found if you leave them as warnings and just continue on.  I
have been finding them by when the current python version just crashes
(without any useful message before your current change) I rerun the
htmldocs using the perl version to get the name of the missing file and
then report it so it can be fixed.  But the perl version continues on
and produces all the other warnings so I can compare with the previous
and only report new errors/warnigs.  Sometime these reports are not
foxed for days or weeks (or months).

So, please, now that you are producing more warnings, make a missing
file just a warning (or at least continue on).  I have enough to do
every day without having to run "make htmldocs" more than once.

-- 
Cheers,
Stephen Rothwell

Attachment: pgp5Q1ZYMYux1.pgp
Description: OpenPGP digital signature


[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux