Subject: Re: linux-next: build failure after merge of the gpio-intel tree

From: Stephen Rothwell <[email-masked]>
Date: Fri, 16 May 2025 19:42:37 +1000

Hi Andy,

On Fri, 16 May 2025 12:36:40 +0300 Andy Shevchenko <[email-masked]> wrote:
>
> On Fri, May 16, 2025 at 07:34:36PM +1000, Stephen Rothwell wrote:
> > Hi all,
> > 
> > After merging the gpio-intel tree, today's linux-next build (htmldocs)
> > failed like this:
> > 
> > Error: Cannot open file /home/sfr/next/next/drivers/gpio/gpiolib-acpi.c
> > 
> > Caused by commit
> > 
> >   babb541af627 ("gpiolib: acpi: Move quirks to a separate file")
> > 
> > I have to run
> > 
> > make KERNELDOC=$(pwd)/scripts/kernel-doc.pl htmldocs
> > 
> > as the newer Python version dies without a useful error :-(  
> 
> Thanks for the report! And can you share the output of the above?

make[1]: Entering directory '/home/sfr/next/htmldocs'
  PARSE   include/uapi/linux/dvb/ca.h
  PARSE   include/uapi/linux/dvb/dmx.h
  PARSE   include/uapi/linux/dvb/frontend.h
  PARSE   include/uapi/linux/dvb/net.h
  PARSE   include/uapi/linux/videodev2.h
  PARSE   include/uapi/linux/media.h
  PARSE   include/uapi/linux/cec.h
  PARSE   include/uapi/linux/lirc.h
Using alabaster theme
Using Python kernel-doc
/home/sfr/next/next/Documentation/bpf/bpf_iterators.rst:55: WARNING: Bullet list ends without a blank line; unexpected unindent. [docutils]
WARNING: /home/sfr/next/next/kernel/futex/futex.h:207 struct member 'drop_hb_ref' not described in 'futex_q'
WARNING: /home/sfr/next/next/kernel/futex/waitwake.c:593 function parameter 'task' not described in 'futex_wait_setup'
/home/sfr/next/next/Documentation/virt/kvm/x86/intel-tdx.rst:255: WARNING: Footnote [1] is not referenced. [ref.footnote]

Sphinx error:
Sphinx is unable to load the master document (/home/sfr/next/next/Documentation/index.rst). The master document must be within the source directory or a subdirectory of it.
make[3]: *** [/home/sfr/next/next/Documentation/Makefile:123: htmldocs] Error 2
make[2]: *** [/home/sfr/next/next/Makefile:1803: htmldocs] Error 2
make[1]: *** [/home/sfr/next/next/Makefile:248: __sub-make] Error 2
make[1]: Leaving directory '/home/sfr/next/htmldocs'
make: *** [Makefile:248: __sub-make] Error 2

This is already being discussed in another thread.

https://lore.kernel.org/all/[email-masked]/
-- 
Cheers,
Stephen Rothwell