Re: [PATCH v2 23/24] scripts: sphinx-build-wrapper: get rid of uapi/media Makefile

From: Mauro Carvalho Chehab
Date: Fri Aug 22 2025 - 10:41:57 EST


On Fri, Aug 22, 2025 at 04:19:35PM +0200, Mauro Carvalho Chehab wrote:
> Now that kernel-include directive supports parsing data
> structs directly, we can finally get rid of the horrible hack
> we added to support parsing media uAPI symbols.
>
> As a side effect, Documentation/output doesn't have anymore
> media auto-generated .rst files on it.
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> ---
> Documentation/Makefile | 3 +-
> Documentation/userspace-api/media/Makefile | 64 --
> .../userspace-api/media/cec/cec-header.rst | 5 +-
> .../media/{ => cec}/cec.h.rst.exceptions | 0
> .../media/{ => dvb}/ca.h.rst.exceptions | 0
> .../media/{ => dvb}/dmx.h.rst.exceptions | 0
> .../media/{ => dvb}/frontend.h.rst.exceptions | 0
> .../userspace-api/media/dvb/headers.rst | 17 +-
> .../media/{ => dvb}/net.h.rst.exceptions | 0
> .../media/mediactl/media-header.rst | 5 +-
> .../{ => mediactl}/media.h.rst.exceptions | 0
> .../userspace-api/media/rc/lirc-header.rst | 4 +-
> .../media/{ => rc}/lirc.h.rst.exceptions | 0
> .../userspace-api/media/v4l/videodev.rst | 4 +-
> .../{ => v4l}/videodev2.h.rst.exceptions | 0
> scripts/sphinx-build-wrapper | 719 ++++++++++++++++++
> 16 files changed, 745 insertions(+), 76 deletions(-)
> delete mode 100644 Documentation/userspace-api/media/Makefile
> rename Documentation/userspace-api/media/{ => cec}/cec.h.rst.exceptions (100%)
> rename Documentation/userspace-api/media/{ => dvb}/ca.h.rst.exceptions (100%)
> rename Documentation/userspace-api/media/{ => dvb}/dmx.h.rst.exceptions (100%)
> rename Documentation/userspace-api/media/{ => dvb}/frontend.h.rst.exceptions (100%)
> rename Documentation/userspace-api/media/{ => dvb}/net.h.rst.exceptions (100%)
> rename Documentation/userspace-api/media/{ => mediactl}/media.h.rst.exceptions (100%)
> rename Documentation/userspace-api/media/{ => rc}/lirc.h.rst.exceptions (100%)
> rename Documentation/userspace-api/media/{ => v4l}/videodev2.h.rst.exceptions (100%)

Heh, this is is obviously wrong:
> create mode 100755 scripts/sphinx-build-wrapper

This patch should be, instead: