linux-kernel - Re: [PATCH 5.1 56/85] doc: Cope with the deprecation of AutoReporter

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20190610073119.GB20470@kroah.com>
Date:   Mon, 10 Jun 2019 09:31:19 +0200
From:   Greg Kroah-Hartman <gregkh@...uxfoundation.org>
To:     Jiri Slaby <jslaby@...e.cz>
Cc:     linux-kernel@...r.kernel.org, stable@...r.kernel.org,
        Jonathan Corbet <corbet@....net>
Subject: Re: [PATCH 5.1 56/85] doc: Cope with the deprecation of AutoReporter

On Mon, Jun 10, 2019 at 08:27:30AM +0200, Jiri Slaby wrote:
> On 07. 06. 19, 17:39, Greg Kroah-Hartman wrote:
> > From: Jonathan Corbet <corbet@....net>
> > 
> > commit 2404dad1f67f8917e30fc22a85e0dbcc85b99955 upstream.
> > 
> > AutoReporter is going away; recent versions of sphinx emit a warning like:
> > 
> >   Documentation/sphinx/kerneldoc.py:125:
> >       RemovedInSphinx20Warning: AutodocReporter is now deprecated.
> >       Use sphinx.util.docutils.switch_source_input() instead.
> > 
> > Make the switch.  But switch_source_input() only showed up in 1.7, so we
> > have to do ugly version checks to keep things working in older versions.
> 
> Hi,
> 
> this patch breaks our build of kernel-docs on 5.1.*:
> https://build.opensuse.org/package/live_build_log/Kernel:stable/kernel-docs/standard/x86_64
> 
> The error is:
> [  250s] reST markup error:
> [  250s]
> /home/abuild/rpmbuild/BUILD/kernel-docs-5.1.8/linux-5.1/Documentation/gpu/i915.rst:403:
> (SEVERE/4) Title level inconsistent:
> [  250s]
> [  250s] Global GTT Fence Handling
> [  250s] ~~~~~~~~~~~~~~~~~~~~~~~~~
> 
> Reverting the patch from 5.1.* makes it work again.
> 
> 5.2-rc3 (includes the patch) is OK:
> https://build.opensuse.org/package/live_build_log/Kernel:HEAD/kernel-docs/standard/x86_64
> 
> So 5.1.* must be missing something now.

Odd.  running 'make htmldocs' on 5.1 with these patches applied works
for me here.

What version of sphinx are you using to build the package with?

thanks,

greg k-h