Re: [PATCH v4 5/6] docs/zh_CN: doc-guide: document macOS Sphinx setup

[Weijie Yuan <wy@wyuan.org>]

On Sun, Aug 16, 2026 at 01:25:51PM +0800, Dongliang Mu wrote:
> > > > diff --git a/Documentation/translations/zh_CN/doc-guide/sphinx.rst b/Documentation/translations/zh_CN/doc-guide/sphinx.rst
> > > > index 3375c6f3a..e6d42d970 100644
> > > > --- a/Documentation/translations/zh_CN/doc-guide/sphinx.rst
> > > > +++ b/Documentation/translations/zh_CN/doc-guide/sphinx.rst
> > > > @@ -110,6 +110,22 @@ PDF和LaTeX构建
> > > >    	使用Sphinx的系统打包，而不是Python虚拟环境。
> > > > +macOS 默认使用不区分文件名大小写的 APFS 卷，而内核源码树中存在仅大小写
> > > > +不同的文件。克隆源码前，请用 ``diskutil apfs list`` 找到 APFS 容器标识符，
> > > > +将下面的 ``diskX`` 替换为该标识符，并创建一个额外的大小写敏感卷::
> > > > +
> > > > +	diskutil apfs addVolume diskX APFSX Linux
> > > > +
> > > > +在 macOS 上，该脚本使用 Homebrew 安装系统依赖，输出的 Homebrew 命令不需要
> > > > +``sudo``。PDF 工具链由 ``mactex-no-gui`` cask 提供，所需的 DejaVu 和 Noto CJK
> > > > +字体则通过 Homebrew font cask 安装；如果只构建 HTML 文档，请使用 ``--no-pdf``。
> > > > +安装 MacTeX 后，请重新启动终端，或运行
> > > > +``eval "$(/usr/libexec/path_helper)"`` 使命令行工具可见。macOS 用户建议使用
> > > > +默认的 Python 虚拟环境，因为 PyYAML 会从
> > > > +``Documentation/sphinx/requirements.txt`` 安装，而不是通过 Homebrew 安装。
> > > > +该脚本还会检查 GNU Make 4.0 或更高版本；如果 Homebrew 将其安装为
> > > > +``gmake``，请使用 ``gmake htmldocs``，而不是 ``make htmldocs``。
> > > > +
> > > Hi Chen Miao,
> > > 
> > > The zh_CN only keeps the translations, therefore, you should first put this
> > > part into the english documenation.
> > > 
> > > Of course, you can extend this patch into one with English and zh_CN
> > > changes.
> > The English Documentation for this is in [PATCH v4 2/6], so you mean
> > it's better to wait until the English part is merged, then we can apply
> > the Chinese translation part, I guess.
> 
> Oops, I missed this patch.
> 
> Yes, I mean, this patchset should only changes the English documentation.
> And then submit another patch to sync the zh_CN translation.
> 
> The changes to how-to.rst does not affect English documentation and I had
> commented with my reviewed-by tag.

OK, thanks!

> > But wait..:
> > 
> > +该脚本还会检查 GNU Make 4.0 或更高版本；如果 Homebrew 将其安装为
> > +``gmake``，请使用 ``gmake htmldocs``，而不是 ``make htmldocs``。
> > 
> > Now I find that this part above is not in the original patch for English
> > Docs, did you miss it on purpose? Sorry I didn't notice this in last
> > rerolls.
>
> I think Chen Miao might miss it unintentionally since this change is in
> another patch.

omg, I somehow missed the English original in [PATCH v4 3/6], too. Then
it's my fault. Chen Miao merged two parts of changes for English Docs
into one Chinese translation patch here. So he's right. I was just in a
rush to send out the email and didn't take the time to double-check my
question. Sorry for my recklessness.

Thanks!