• Bug#1064035: Missing documentation due to error in kernel-doc script

    From Ben Hutchings@21:1/5 to All on Fri Feb 16 03:20:01 2024
    XPost: linux.debian.kernel

    Package: linux-doc-5.10
    Version: 5.10.209-1
    Severity: important

    The backport of commit 3080ea5553cc "stddef: Introduce
    DECLARE_FLEX_ARRAY() helper" modified scripts/kernel-doc and
    introduced a syntax error:

    Global symbol "$args" requires explicit package name (did you forget to declare "my $args"?) at ./scripts/kernel-doc line 1236.
    Global symbol "$args" requires explicit package name (did you forget to declare "my $args"?) at ./scripts/kernel-doc line 1236.
    Execution of ./scripts/kernel-doc aborted due to compilation errors.

    This doesn't stop the documentation build process, but causes the
    documentation that should be extracted by kernel-doc to be missing
    from linux-doc-5.10.

    We should be able to fix this by eithering backport commit
    e86bdb24375a "scripts: kernel-doc: reduce repeated regex expressions
    into variables" or replacing /$args/ with /([^,)]+)/.

    Ben.

    -- System Information:
    Debian Release: trixie/sid
    APT prefers unstable-debug
    APT policy: (500, 'unstable-debug'), (500, 'stable-updates'), (500, 'stable-security'), (500, 'oldstable-updates'), (500, 'oldstable-security'), (500, 'oldoldstable-updates'), (500, 'oldoldstable'), (500, 'unstable'), (500, 'stable'), (500, 'oldstable')
    , (1, 'experimental')
    Architecture: amd64 (x86_64)
    Foreign Architectures: i386

    Kernel: Linux 6.5.0-4-amd64 (SMP w/12 CPU threads; PREEMPT)
    Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE not set
    Shell: /bin/sh linked to /usr/bin/dash
    Init: systemd (via /run/systemd/system)
    LSM: AppArmor: enabled

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)