From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id EF66FCE9D7D for ; Tue, 6 Jan 2026 16:39:24 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vdA5M-0005Zw-LX; Tue, 06 Jan 2026 11:39:08 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vdA5K-0005U8-E7; Tue, 06 Jan 2026 11:39:07 -0500 Received: from tor.source.kernel.org ([2600:3c04:e001:324:0:1991:8:25]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vdA5J-0005u5-0B; Tue, 06 Jan 2026 11:39:06 -0500 Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by tor.source.kernel.org (Postfix) with ESMTP id 217D660008; Tue, 6 Jan 2026 16:38:56 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id C700BC116C6; Tue, 6 Jan 2026 16:38:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1767717535; bh=cM8YRPJPOKFd2VKH1gGQHoFMqoOIVItkmOBM/MudydA=; h=From:To:Cc:Subject:Date:From; b=b34ykouhmQ3GCRioZyIw4vXF4y58G12vE9l+tq3SbSZAl/roy3jpyqaY3PZ5yS/4P ly15uLOOaH+tf3VHATYHDEl95d85Be69zm5yl4pyK3k93h/buVBDrg7X3CAzGCh8MU gAW6Ucel1ImPMC6SxxFn+mrHiEAoQG2MRPVD+59pcQOu3oMuZNAWKBmeaN0Lrn2kp9 oFYEHqXIplA/Q6vqmTfiohtTZEfFUrvKsGRCFXF57Z41szwWJnMLChF2zlM4iMyerd ApLSOHEuMIder8LwJFh1WQ0I1KLNN0m1i5A+W6CU3J3H9StstGlYBae1Usk2Bk86Uq 8cFkoDb57MkJw== Received: from mchehab by mail.kernel.org with local (Exim 4.99) (envelope-from ) id 1vdA57-00000000Nwg-2qIo; Tue, 06 Jan 2026 17:38:53 +0100 From: Mauro Carvalho Chehab To: Igor Mammedov , "Michael S . Tsirkin" , John Snow , Peter Maydell Cc: Jonathan Cameron , Shiju Jose , qemu-arm@nongnu.org, qemu-devel@nongnu.org, Mauro Carvalho Chehab Subject: [PATCH 0/1] Sync kernel-doc.py with Linux upstream Date: Tue, 6 Jan 2026 17:38:18 +0100 Message-ID: X-Mailer: git-send-email 2.52.0 MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2600:3c04:e001:324:0:1991:8:25; envelope-from=mchehab+huawei@kernel.org; helo=tor.source.kernel.org X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-arm@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-arm-bounces+qemu-arm=archiver.kernel.org@nongnu.org Sender: qemu-arm-bounces+qemu-arm=archiver.kernel.org@nongnu.org Hi Peter/John, There were several updates at kernel-doc upstream fixing bugs, doing cleanups and a couple of improvements. Better to keep QEMU in sync with such changes. Worth mentioning that we did some changes on Linux at the kernel-doc.py script itself, to avoid Kernel build to crash with too old Python versions, as there docs build is a separate target, and python >= 3.6 is a new requirement there. On kernel, if python < 3.6, it will simply ignore docs build (emitting a warning). I opted to not backport such changes, but if you prefer doing that, I can do that on a v2. --- For now, I opted to keep kernel-doc libraries at the same directory as before - e.g. at scripts/lib/kdoc. On Linux, we ended moving it to tools/lib/python/kdoc. It could make sense to move it on QEMU too, as it makes a little bit easier to keep things in sync. What do you think? Mauro Carvalho Chehab (1): kernel-doc.py: sync with upstream Kernel v6.19-rc4 scripts/lib/kdoc/kdoc_files.py | 11 +- scripts/lib/kdoc/kdoc_item.py | 3 +- scripts/lib/kdoc/kdoc_output.py | 93 +++- scripts/lib/kdoc/kdoc_parser.py | 897 ++++++++++++++++---------------- scripts/lib/kdoc/kdoc_re.py | 24 +- 5 files changed, 554 insertions(+), 474 deletions(-) -- 2.52.0