From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=91.218.175.224 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794638777; b=QUOuoRKegqoWYX9Dzt5K+DrlR3iRAg1v5IjnadCO3uFXXkh8QpVHVZGKRUNi2gIY2dwr 2XPEt8XOKq4KzNigoTt9BjQkwF2By0lNkslBkhodF+c9hIAgKnSsUzcJsAhFkUq4mSi4z HWCNnMJXXCVRHlHQeHaa7unRoxFuVqyvv728Z2bvTMjkVzRyqjOq8Xm3VUL4/OMPtAHFY /GQiLnwfzXs6PVty/7Eh98nXBw5R6fs9JVDsFEZ1pyO7jfz8oAaVT/hhkL9wnGP8EvvcB mu7Z8NnQ0Flv1N0wm5+Ykbl1fgSf3MsvK5ZHJNcXicVWQrSrSHdoYjpAtvENStUPHiw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794638777; h=DMARC-Filter:X-Envelope-To:DKIM-Signature:X-Envelope-To:Received: X-Mizu-Trace-ID:X-Migadu-Flow:Date:From:To:Cc:Subject:Message-ID: References:MIME-Version:Content-Type:Content-Disposition: Content-Transfer-Encoding:In-Reply-To; bh=AaPwVUrayMcOL53EO0YjPrtEQPyzLJXQlPQueQUBdho=; b=l6lBTgWIMGLPoU8EwHQuVrU1JoUndcAOuB/MyslMEw+jKezFHgrLWgfojEe4//OIvAH2 0dqWP5eWEMRxz17NcPkYHJS+9tWbeD4D7hq1aMM2bv9Cbvu6nvmn+kR7yFwfyR91eV9pQ EhDX5b7ruBzMBPAvjg7rNp3SXpFDJTjqfs7hTWLMOZtgSVvs2U3XlA1ZyxEvuCFEHZLfg bwQoAJP4XZGuLNnvubY4nHDR/97ml2roR/bMu+O0qKYGr5Lu5NQYCTRs8m55c0jtpOYDn xP7oYq5J+dgafRHK1uWlkwT9kfFEZ9WRl68sUO+XKfH+Nd35tdCU3QldlQ84W6ttlUA== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=wyuan.org; spf=pass smtp.mailfrom=wyuan.org; dkim=pass header.d=wyuan.org header.i=@wyuan.org header.a=rsa-sha256 header.s=key1 header.b=Y+jzMvuE; arc=none smtp.remote-ip=91.218.175.224 Received: from mta0.migadu.com (out-224.mta0.migadu.com [91.218.175.224]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2DF62606A881 for ; Sat, 14 Nov 2026 06:46:15 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 2DF62606A881 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=wyuan.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=wyuan.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key, unprotected) header.d=wyuan.org header.i=@wyuan.org header.a=rsa-sha256 header.s=key1 header.b=Y+jzMvuE X-Envelope-To: linux-doc@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=3cJyP5lKJCHlA77XpqOzvcgkBdaNcWgWzFkwIUEImyo=; c=simple/simple; d=wyuan.org; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1794638774; v=1; x=1795243574; b=Y+jzMvuEampRL11n2cXF4oeIWscStxjd6yScIQGZFMaNzaYV6LCq1bJKH1ZCzdOfYmXnlx10 f3r0q2xpbgexD5QlfU/0dqKC7xHYTZeh4u4is5gHAFAptf9dA+5bpErzBUSw6SclIkrwT9ukowC sWLtvAJG41tx0GP5HSx/yl7wP896y5hDTHfgdqgz3xPE072LUTl81++30ZWcqRqPPu7ylxriiFu j4SEj/43W27ganBu/Gms8qSTt0zRs6XmCsujolwz0n/Y+N1DlgvAtFOFLEq4UzWQC2+gfFEi0nO Pd6B05DjwgOMX7lhhQThgQt7eyfW3QSsa7j2GHAMtthgA== X-Envelope-To: linux-doc@vger.kernel.org Received: by smtp.migadu.com with ESMTPS id d22ed1a8d6056b74; Sat, 14 Nov 2026 06:46:14 +0000 X-Mizu-Trace-ID: d22ed1a8d6056b74 X-Migadu-Flow: FLOW_OUT Date: Sat, 14 Nov 2026 14:46:03 +0800 From: Weijie Yuan To: =?utf-8?B?6Zey6YCb?= <2368492046@qq.com> Cc: corbet , mchehab , linux-doc , skhan , rdunlap , linux-kernel Subject: Re: [PATCH 0/4] docs: kernel-doc: fix export selection and error handling Message-ID: References: X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: On Sat, Nov 14, 2026 at 01:40:28PM +0800, 闲逛 wrote: > Hi Jonathan and Mauro, > > This series fixes four reproducible kernel-doc issues: > > 1. Multi-file export filtering reuses the first input's exports. > 2. Environment warning-as-error settings do not affect the exit status. > 3. YAML error paths call sys.exit() without importing sys. > 4. A separate -export-file triggers a missing-xforms TypeError. > > Each fix includes CLI regression coverage. The warning-policy tests also > cover KDOC_WERROR=0, empty overrides, and command-line precedence. > > Validation on Windows (Python 3.12) and Ubuntu 24.04 under WSL2 > (Python 3.12.3): > > python3 -B -X utf8 -m unittest discover -s tools/unittests > > Ran 131 tests: 127 passed, 4 existing expected failures. > > The series is based on mainline commit > b3dfbde62cf1981c4638939c159dfd087b7a72e9. > A complete Sphinx documentation build has not been performed. May I ask why? You could just run 'make htmldocs'. > I could not verify docs-next because the server's TLS connection > failed; checking for equivalent pending mailing-list patches is also > incomplete. I don't believe you can not clone Jon's repo and checkout docs-next branch. Is there any reason? (Looks like git.lwn.net is doing a pretty good job of keeping AI crawlers out.;)) And I suspect that this part is the output of your agent. :) > Codex assisted with reproducing the failures, preparing the fixes and > regression tests, and executing the tests. The task was to inspect and > repair kernel-doc behavior in a local Linux source tree. I have reviewed > the changes and requested that my Signed-off-by be recorded. Thanks for the disclosure, but this may not be put in the commit message of your patches. They should better be under '---'. And please see also: "no attachments" https://docs.kernel.org/process/submitting-patches.html#no-mime-no-links-no-compression-no-attachments-just-plain-text Thanks.