From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mta1.migadu.com (out-23.mta1.migadu.com [95.215.58.23]) (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 B9C69406269 for ; Fri, 2 Oct 2026 06:44:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=95.215.58.23 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790923489; cv=none; b=O+0RXUHot03QfGUqiISIVa0YPiwv+34Qm13bd6uDmuzgKmt9Z3814Tcgg+fipwHBxkcpAHmnhfq9VAtw3sCPMKebiABlDO9otrvKmrXBNSqiSo5pnvgkZ3SAHiTdy/taO3R9GeDc23HeaCIGrVJCZbsMdgB/2aVkjdpFT3bN8CM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790923489; c=relaxed/simple; bh=FG3G5EHQ/BDjiLxln/wtrqjYmH9Jopa4k1oSLbYIXqU=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=UdiKl5rUkI5Nas0X+QGeXFaLVHCSdfP/nxGXg1Vbjjfu213zgsOHRwDzS6kam2U8PtTOT8OSp5H26yC84K1BZChu6GSBpMSidLCX3+sA6MLqLuVBlQwLNykddekh2W++btDodN/+xIdEeMHDyZYzrC6KqKouy1jIbkyXS65QrdQ= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=wyuan.org; spf=pass smtp.mailfrom=wyuan.org; dkim=pass (2048-bit key) header.d=wyuan.org header.i=@wyuan.org header.b=gU3t2Yqj; arc=none smtp.client-ip=95.215.58.23 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) header.d=wyuan.org header.i=@wyuan.org header.b="gU3t2Yqj" X-Envelope-To: linux-doc@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=FG3G5EHQ/BDjiLxln/wtrqjYmH9Jopa4k1oSLbYIXqU=; c=simple/simple; d=wyuan.org; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1790923484; v=1; x=1791528284; b=gU3t2Yqj5ekpMYQjMfOcIrce/Nm3RlUlQas2mq6wfdYr0qsbhYFEHeCA/orQmNxf0YsKyu5W S5bJR7NqadTeTs1mlkzOhHQNQR+9TttjdFs24r8Iqg/IUc1d8lpycEGb1Nlggn3ZFf5twsqWoGP /GhCGqsLClUN0dDYvbkHthdC4QmKedoeBhtn67P7sOVca52E2kZalSD3jRFIcxK1nG0fFzgrnUo fHOls/l+XoP0cUMBIiW+ZR0vbtcgKxHRE1v1zvZ+hfj0cPSozBpLY2LY5AeBuInXpRAo06o4t1j D7IF0YUVx4Vxx4ceP9m7v5/9m1DUYijlav3KTbiLpkVLA== X-Envelope-To: linux-doc@vger.kernel.org Received: by smtp.migadu.com with ESMTPS id 36942001d6a6b8cc; Fri, 02 Oct 2026 06:44:44 +0000 X-Mizu-Trace-ID: 36942001d6a6b8cc X-Migadu-Flow: FLOW_OUT Date: Fri, 2 Oct 2026 14:44:32 +0800 From: Weijie Yuan To: Chen-Yu Yeh Cc: corbet@lwn.net, alexs@kernel.org, dzm91@hust.edu.cn, si.yanteng@linux.dev, srcres258@furdevs.cn, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] docs/zh_TW: remove the unreachable plain-text translations Message-ID: References: <20260929131109.266535-1-chenyou910331@gmail.com> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20260929131109.266535-1-chenyou910331@gmail.com> On 2026-09-29 21:11:07 +0800, Chen-Yu Yeh wrote: > These nine files predate the move of the documentation to > reStructuredText. Sphinx only reads .rst sources, so none of them is > part of the built documentation, and nothing in the zh_TW tree refers to > them; they can only be found by browsing the source tree. > > zh_TW file English original > IRQ.txt core-api/irq/index.rst > io_ordering.txt driver-api/io_ordering.rst > arch/arm/Booting arch/arm/booting.rst > arch/arm/kernel_user_helpers.txt arch/arm/kernel_user_helpers.rst > arch/arm64/booting.txt arch/arm64/booting.rst > arch/arm64/legacy_instructions.txt arch/arm64/legacy_instructions.rst > arch/arm64/memory.txt arch/arm64/memory.rst > arch/arm64/silicon-errata.txt arch/arm64/silicon-errata.rst > arch/arm64/tagged-pointers.txt arch/arm64/tagged-pointers.rst > > Beyond the format, two of them no longer line up with the English tree > at all: core-api/irq/index.rst is now only a toctree, the prose IRQ.txt > translates having moved to core-api/irq/concepts.rst, and > io_ordering.txt sits at the top level although its original lives under > driver-api/. > > As proposed in the zh_TW scope discussion and agreed there, remove them > rather than convert them. arch/arm/Booting was also listed in the > proposal as a translation whose original had moved; being one of these > files, it is removed rather than relocated. > > Link: https://lore.kernel.org/linux-doc/CAKspUhJAbCWoxgh2eq8R5g_MiNK=oXgKPUWqGOpHh0w1-Fv74A@mail.gmail.com/ > Link: https://lore.kernel.org/linux-doc/ap5xEtMdwXS8Pvcf@wyuan.org/ > Signed-off-by: Chen-Yu Yeh > --- > This applies on top of v2 of the contact-block cleanup: > https://lore.kernel.org/linux-doc/20260929115956.229610-1-chenyou910331@gmail.com/ > > That series still edits IRQ.txt, io_ordering.txt and the arch/arm{,64} > plain-text files (3/7 and 7/7) so that it stands on its own; once this > patch lands those hunks are moot. That also answers Jon's question on > v1 7/7 about handling the old files together with the wider update: > they are removed here instead. So please don't forget to check the sequence when applying this. :) Tested with 'make cleandocs && make htmldocs', no extra warnings caused. Acked-by: Weijie Yuan Thanks.