From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f176.google.com (mail-pf1-f176.google.com [209.85.210.176]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 26FD03A0B37 for ; Wed, 7 Jan 2026 23:46:25 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.176 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767829586; cv=none; b=Um7Q8EqANp1vscyG4zkUY+yp3l/vi7TBbKLBMHA8SgmQF6Z9LJFggfoIC+6kDNXaBrDx1AWxKMoqrdvXtBSxm/3S2qHV2BNHpnDgXv65UbKH8LRN337+dKK0egwGMKOYzy7dvzmNUo946Z6CmnC+zv6g1vZ1/OTi33SycshWK1E= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767829586; c=relaxed/simple; bh=5lkCo2Bcdh2eobJrag13J+RX/0T+fcr6NPLzhfLUZeI=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=bQMgSvCZ8NGNy4b1z9spBNC4PVKISH2XKyT2AQ1QsnNJjYDeB46MMCWXwscC65yLLsAzO//BEKQkh2Z7DjXQw3U+MszUd3i3nY3ZP24ByVfOgsX9WgV6qWZq3iQY2OHgcFPxVNZAmyLANjTq6jSpgRrqDBe/FIBEVUtg4Yl/VMk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=ddaq+9HZ; arc=none smtp.client-ip=209.85.210.176 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="ddaq+9HZ" Received: by mail-pf1-f176.google.com with SMTP id d2e1a72fcca58-7f121c00dedso2405700b3a.0 for ; Wed, 07 Jan 2026 15:46:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1767829584; x=1768434384; darn=vger.kernel.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=5lkCo2Bcdh2eobJrag13J+RX/0T+fcr6NPLzhfLUZeI=; b=ddaq+9HZQZKOVb0M3Z6eQh3VW5cLxQHA3OmOfd9NRrYFdzr1xTDdUSq56+QFu6/Xc0 axbnoW6ThykfX54L/AhzViuv9NMecf9QfmUgGFzQ5303JTYPaNDHw1OLnbf0QJB3KmRA 33BqrfyCQKAxvh//0cjuOr/NC46xKdpeF3xfhs2agdpPNUUm4pNmAU2smIWFmXL+2YyU CQq1oRRD4Z2BV0pYlzJ/dXC+H77ixGkEvtcVx564n0qaGxXhSkZkwXlAcvZlHmPlIz6K UBAIAJWHOn0W1YooXtfG5RCSGMDFXLGZqvWL5hux2d6PB0bgh4jf56Usi2nwdWNXszWd m6bQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1767829584; x=1768434384; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-gg:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=5lkCo2Bcdh2eobJrag13J+RX/0T+fcr6NPLzhfLUZeI=; b=HtkIYo3+B1qWODfZi3O/pj2skgRRledDs2e8F7kU42cCM+6DEAd8ZmHX0rjTCzUMuZ ywlXgZu5/tpPnTYZwKLWl4IZ+UCJYDIOgtBAz/iHiEU8o/9PmaddGn2NOl/YGurZ5C4g 2vwhUj8LoCZN74GKnJAu+l1Fh2ldtFejOdsgOYxcYcyRp84xiQjsK3e90Dc9e6Ph/coE 5HJ7lfQh60FsQwvJnolWTJ1qTFGRXc1EJZFFbCEoTuOtKwixK5vflu3XgWURPVkfKJ7j U8fIDcGqJl3mEGeQ2Nmwmw1fwTkdwDbQW9lpMO2kqOzDr+DYb4c7ZHh50WOHsTtdk7DY W76g== X-Forwarded-Encrypted: i=1; AJvYcCXxaQdVJUqKcknxLjqB9J4cnuKwidMcxc7sLcVYaFpcE3v1VsO/K/GW0J+9t23UkNlIvvtfbE2NMijVMvE=@vger.kernel.org X-Gm-Message-State: AOJu0YwZcoI4WOR6UlLZ3ZB1zo8JRdbThtEH5z898e/y8raEztdZ8yWB ETPep5pv9jpcyjLmuyre1NnwZgVaA0p7ApG1Db4uzYvTcmyE7MsZ1UZPQnQMXG6H X-Gm-Gg: AY/fxX6R1zK0tRcI5U94FSQkCPCZg17Ws7b7Vov3O1PhC5w/63/VeUvZRkeQqKFivPE Vm+rbIkxBA/FwV53FOILgqcVIVg6J6VdS8wt+fA70Obq5oAGrZfqJ/DWGoadQBrZuMXNVzxEgGm qUMPCnIHV3dqkVuQYGzFWd2h/V04bElpQDiYNcCq5YPilcDbOiv9ESRnZqUK1Qfb+gYlZy897Hx GFxA+xkENUZnvz7wNGwBQHW/dvn/wfVP2hGdRmgiIJ7j0mLL9L9H0uX8c36NdpluzyjccTHsyBs +kaYIH/U7gKMQfsNWDkXsMts1geKzFQ+sj4juHAdFlcJQNpQGF5fcDnhiaYJ+o10mDsxEmRa/T0 H3CACZ2HYfqPvsLuMHjdcY/5sYFmgisN175pzBzyOrTl+vOSHdCoHgtmMt2jwqOGU2o6Z5OQ6/F iCK10iujjnBIk= X-Google-Smtp-Source: AGHT+IEuDYmNMp5sGDX6zmUVtDt4gxTdUsbu3GSb//0p0hx6zc8cYvZZp5jNv1GBUYp1AmXY6DK5Bw== X-Received: by 2002:a05:6a00:12cd:b0:7f7:5d81:172b with SMTP id d2e1a72fcca58-81b7f6ec17emr4090626b3a.42.1767829584411; Wed, 07 Jan 2026 15:46:24 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-819bab0da0bsm5782245b3a.13.2026.01.07.15.46.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 07 Jan 2026 15:46:23 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 2948C42805C9; Thu, 08 Jan 2026 06:46:21 +0700 (WIB) Date: Thu, 8 Jan 2026 06:46:20 +0700 From: Bagas Sanjaya To: Randy Dunlap , Jonathan Corbet , Linux Kernel Mailing List , Linux Documentation , Linux Regressions Cc: Mauro Carvalho Chehab Subject: Re: [REGRESSION] Unexpected section title false positive warnings on DOC: directive Message-ID: References: <87ikdecsj0.fsf@trenco.lwn.net> <966fffa3-a91b-425e-b915-891299832e36@infradead.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="Hv2YtufuJ29ReXgO" Content-Disposition: inline In-Reply-To: <966fffa3-a91b-425e-b915-891299832e36@infradead.org> --Hv2YtufuJ29ReXgO Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Jan 07, 2026 at 10:19:32AM -0800, Randy Dunlap wrote: >=20 >=20 > On 1/7/26 5:08 AM, Bagas Sanjaya wrote: > > On Tue, Jan 06, 2026 at 02:58:43PM -0700, Jonathan Corbet wrote: > >> Bagas Sanjaya writes: > >> > >>> Hi, > >>> > >>> Building htmldocs on docs-next currenly produces about 50 new warning= s; which > >>> all of them are unexpected section title on DOC: kernel-doc directive= , like: > >>> > >>> /home/bagas/repo/linux-kernel/Documentation/driver-api/target:25: ./d= rivers/target/target_core_user.c:35: CRITICAL: Unexpected section title. > >>> > >>> Userspace I/O > >>> ------------- [docutils] > >>> WARNING: kernel-doc 'scripts/kernel-doc.py -rst -enable-lineno -funct= ion 'Userspace I/O' ./drivers/target/target_core_user.c' processing failed = with: SystemMessage('/home/bagas/repo/linux-kernel/Documentation/driver-api= /target:25: ./drivers/target/target_core_user.c:35: (SEVERE/4) Unexpected s= ection title.\n\nUserspace I/O\n-------------') > >>> /home/bagas/repo/linux-kernel/Documentation/driver-api/target:28: ./i= nclude/uapi/linux/target_core_user.h:14: CRITICAL: Unexpected section title. > >> > >> So I did not, and do not, see any of these errors; are you doing > >> something special to get them? > >=20 > > Nope. > >=20 > > I'm running my htmldocs builds on my Arch Linux system (with Sphinx 9.0= =2E4 and > > Python 3.13.11). > >=20 > > Full log (tarred up) attached. > >=20 > > Thanks. >=20 > Hi, > What docutils version, please? Mine have: docutils (Docutils 0.21.2, Python 3.13.11, on linux) Thanks. --=20 An old man doll... just what I always wanted! - Clara --Hv2YtufuJ29ReXgO Content-Type: application/pgp-signature; name=signature.asc -----BEGIN PGP SIGNATURE----- iHUEABYKAB0WIQSSYQ6Cy7oyFNCHrUH2uYlJVVFOowUCaV7wSAAKCRD2uYlJVVFO o9t8AQDhw/m4nIujYigOdA2aNi2jne6Vev8KUsOHYlY7yCWDJAEAviAWbCThgrYO VA0SnKeeFVAPM8V/w7O6kLO2o9OwygU= =rb4s -----END PGP SIGNATURE----- --Hv2YtufuJ29ReXgO--