From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mta0.migadu.com (out-172.mta0.migadu.com [91.218.175.172]) (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 3B0C036605D for ; Thu, 13 Aug 2026 15:46:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.172 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786636005; cv=none; b=Mg/vaQStxMQvXTRAxpEu1QPmoqeoKuSlV0AFSncRMevy917FsCCuuy37I4/rH/YyIWx1iSkNqCIYD6iFKpi27vITx5NIRTx8rsSFkFgrP90odS1cHL0x5QokMl7Ih1JrYtnluE+L711YLu2eYdhDpvwp9U6GlE0+j7r7ybdcwkE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786636005; c=relaxed/simple; bh=3AaV6yDkVusNOtmocxOEL86UfXP8VtFp7I2nK4osGp0=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=DJ+fL5wtotmh04X6Pox15t7GJtkYRbkBr+txVkSDKJ2PJZsXQd1BIDLUjy4AlxWPNEg/+NO2mdc5L1LP0NFWXsYskvF+pvi9aGijt3pBtMJn4rk89es3ewrknf82Y4X+RbehaMjO276USxoKyO02TSHl0ytEOgfCJ+K4DxurjTY= 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=EIIvph4b; arc=none smtp.client-ip=91.218.175.172 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="EIIvph4b" X-Envelope-To: linux-doc@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=3AaV6yDkVusNOtmocxOEL86UfXP8VtFp7I2nK4osGp0=; c=simple/simple; d=wyuan.org; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1786635997; v=1; x=1787240797; b=EIIvph4b/6O6b63CJUdqT7xKP6IyGjVdmv/3t7uYzAu5h/X48jY+fbt1OQMrwL6JWa/NghsC uhUqoNsQDWUrekBaSKMGqmZe6ra/WYlKUX7j0i9Fq1pfkq6EsDOHZSVICKOaXxzFwSAZbiLf/Jv WKBNdqFEYMcaQVMk3xh/+Q1LT9wB60r3XkrfmYgmLr46lKOvGWI5Qfh1gmu4a4E1xAmYjW76i4i hsvNubGAY9TbHAb/57zYJUfzoJKDF6zrOFB5OjikUdbkBGFOFfyvFXRVDyy/9N9RopQhWTfOsIQ d2D8ab9oo2E/y+flvlXtfUnc2k88D1EbZDfKeToL0geZg== X-Envelope-To: linux-doc@vger.kernel.org Received: from localhost (117.176.242.163) by smtp.migadu.com with ESMTPS id 0ec660fca0567486; Thu, 13 Aug 2026 15:46:37 +0000 X-Migadu-Flow: FLOW_OUT Date: Thu, 13 Aug 2026 23:46:34 +0800 From: Weijie Yuan To: Chen Miao Cc: corbet@lwn.net, alexs@kernel.org, si.yanteng@linux.dev, skhan@linuxfoundation.org, dzm91@hust.edu.cn, mchehab@kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v3 6/6] docs/zh_CN: how-to: document case-sensitive APFS setup Message-ID: References: <20260812182327.53694-1-chenmiao.ku@gmail.com> <20260812182327.53694-7-chenmiao.ku@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=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20260812182327.53694-7-chenmiao.ku@gmail.com> On Thu, Aug 13, 2026 at 02:23:23AM +0800, Chen Miao wrote: > The APFS volume used by macOS is case-insensitive by default, while the > kernel tree contains file names that differ only in case. Document the > diskutil commands needed to identify the APFS container and add a > case-sensitive volume before cloning the tree. > > Signed-off-by: Chen Miao Acked-by: Weijie Yuan > --- > Documentation/translations/zh_CN/how-to.rst | 8 ++++++++ > 1 file changed, 8 insertions(+) > > diff --git a/Documentation/translations/zh_CN/how-to.rst b/Documentation/translations/zh_CN/how-to.rst > index 9ec2384e1..e1d3d2b8b 100644 > --- a/Documentation/translations/zh_CN/how-to.rst > +++ b/Documentation/translations/zh_CN/how-to.rst > @@ -102,6 +102,14 @@ Linux 发行版和简单地使用 Linux 命令行，那么可以迅速开始了 > 开头的命令。**请注意**，最新版本 Sphinx 的文档编译速度有极大提升，强烈建议 > 您通过 pip/pypi 安装最新版本 Sphinx。 > > +macOS 默认使用不区分文件名大小写的 APFS 卷，而内核源码树中存在仅大小写 > +不同的文件。在执行 ``git clone`` 前，可在现有 APFS 容器中创建一个额外的大小写 > +敏感卷（先用 ``diskutil apfs list`` 找到容器标识符，并将下面的 ``diskX`` 替换为该标识符）:: > + > + diskutil apfs addVolume diskX APFSX Linux > + > +然后将内核源码克隆到新卷中。 > + > 如果您处于一个多用户环境中，为了避免对其他人造成影响，建议您配置单用户 > sphinx 虚拟环境，即只需要执行:: Nit: In the subsequent content of this article, all commands use "make", not "gmake". So, is it necessary to mention the content of the patch [5/6] here? (Use gmake from Homebrew instead of make from Apple), like a cross-reference, to lead the macOS users to get more detailed info. But I'm fine with currunt wordings. Because if you try to use 'make', you'll get Makefile:15: *** GNU Make >= 4.0 is required. Your Make version is 3.81. Stop. then, you should realize that Homebrew had told you that you should run 'gmake' instead of 'make'. Thanks.