mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Dongliang Mu <dzm91@hust.edu.cn>
To: Chen Miao <chenmiao.ku@gmail.com>,
	corbet@lwn.net, alexs@kernel.org, si.yanteng@linux.dev,
	skhan@linuxfoundation.org, mchehab@kernel.org, wy@wyuan.org
Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH v4 6/6] docs/zh_CN: how-to: document case-sensitive APFS setup
Date: Sun, 16 Aug 2026 12:54:15 +0800	[thread overview]
Message-ID: <1043962f-69e1-40cd-8f67-cc91f2f1c488@hust.edu.cn> (raw)
In-Reply-To: <20260814214419.49925-7-chenmiao.ku@gmail.com>


On 8/15/26 5:44 AM, 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 <chenmiao.ku@gmail.com>
> Acked-by: Weijie Yuan <wy@wyuan.org>

Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>

BTW, this how-to file is only guidance for Chinese contributors. So 
there is no original English documentation and we don't need change the 
english documentation at the same time.

Dongliang Mu

> ---
>   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 虚拟环境,即只需要执行::
>   


      reply	other threads:[~2026-08-16  4:55 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-08-14 21:44 [PATCH v4 0/6] docs: sphinx-pre-install: improve dependency checks Chen Miao
2026-08-14 21:44 ` [PATCH v4 1/6] docs: kdoc: add GNU Make detection Chen Miao
2026-08-14 21:44 ` [PATCH v4 2/6] docs: sphinx-pre-install: add macOS Homebrew support Chen Miao
2026-08-14 21:44 ` [PATCH v4 3/6] docs: sphinx-pre-install: check GNU Make version Chen Miao
2026-08-14 21:44 ` [PATCH v4 4/6] docs: sphinx-build-wrapper: prefer gmake Chen Miao
2026-08-14 21:44 ` [PATCH v4 5/6] docs/zh_CN: doc-guide: document macOS Sphinx setup Chen Miao
2026-08-16  4:52   ` Dongliang Mu
2026-08-16  5:07     ` Weijie Yuan
2026-08-16  5:25       ` Dongliang Mu
2026-08-16  5:38         ` Weijie Yuan
2026-08-14 21:44 ` [PATCH v4 6/6] docs/zh_CN: how-to: document case-sensitive APFS setup Chen Miao
2026-08-16  4:54   ` Dongliang Mu [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1043962f-69e1-40cd-8f67-cc91f2f1c488@hust.edu.cn \
    --to=dzm91@hust.edu.cn \
    --cc=alexs@kernel.org \
    --cc=chenmiao.ku@gmail.com \
    --cc=corbet@lwn.net \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mchehab@kernel.org \
    --cc=si.yanteng@linux.dev \
    --cc=skhan@linuxfoundation.org \
    --cc=wy@wyuan.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®