Thank you! In the past two days I have consulted not only other indexes, but also the Sphinx manual. In the meantime I have done a lot of experimentation. Now I am convinced that: ":maxdepth：1" is appropriate; ":numbered" is not needed. Thanks！ Yanteng > -----原始邮件----- > 发件人: "Namjae Jeon" <namjae.jeon@xxxxxxxxxxx> > 发送时间: 2021-03-19 11:35:39 (星期五) > 收件人: "'司延腾'" <siyanteng@xxxxxxxxxxx> > 抄送: mchehab+huawei@xxxxxxxxxx, "'Steve French'" <stfrench@xxxxxxxxxxxxx>, "'Gibeom Kim'" <gibeomii.kim@xxxxxxxxxxx>, linux-doc@xxxxxxxxxxxxxxx, "'Huacai chen'" <chenhuacai@xxxxxxxxx>, siyanteng@xxxxxxxxx, "'Jonathan > Corbet'" <corbet@xxxxxxx> > 主题: RE: RE: [PATCH 2/2] docs: filesystems: add cifs to the index file > > > Sorry, I copied an index as a base from somewhere else and modified it, obviously I didn't do a very > > nice job and this will cause problems for future developers. Just keep the defaults, can I delete them > > in v2? > Is it really right to delete them? First we have to know what they mean. > When I see Documentation/filesystems/nfs/index.st, :maxdepth is set to 1. > Can you take a look more ? > > > Thanks! > > > > Yanteng > > > > "Namjae Jeon" <namjae.jeon@xxxxxxxxxxx>写道： > > > > Filesystems has a new cifs folder. Add it to the index file. > > > > Should address this warning: > > > > > > > > linux-next/Documentation/filesystems/cifs/cifsd.rst: WARNING: > > > > document isn't included in any toctree > > --- > > > > Documentation/filesystems/cifs/index.rst | 12 ++++++++++++ > > > > Documentation/filesystems/index.rst | 2 +- > > > > 2 files changed, 13 insertions(+), 1 deletion(-) create mode 100644 > > > > Documentation/filesystems/cifs/index.rst > > > > > > > > diff --git a/Documentation/filesystems/cifs/index.rst > > b/Documentation/filesystems/cifs/index.rst > > > > new file mode 100644 > > > > index 000000000000..b4a487e9adff > > --- /dev/null > > +++ > > b/Documentation/filesystems/cifs/index.rst > > > > @@ -0,0 +1,12 @@ > > > > +.. SPDX-License-Identifier: GPL-2.0 > > + > > +==== > > +CIFS > > > > +==== > > + > > +.. toctree:: > > > > + :maxdepth: 2 > > > > + :numbered: > > > Could you please explain what :maxdepth and :numbered are ? > > > > > > Thanks! > > > > + > > > > + cifsd > > > > + cifsroot > > > > diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst > > > > index d4853cb919d2..bdba80ae2bb1 100644 > > --- a/Documentation/filesystems/index.rst > > > > +++ b/Documentation/filesystems/index.rst > > > > @@ -72,7 +72,7 @@ Documentation for filesystem implementations. > > > > befs > > > > bfs > > > > btrfs > > > > - cifs/cifsroot > > > > + cifs/index > > > > ceph > > > > coda > > > > configfs > > > > -- > > > > 2.25.1 > > > > > > > > > </namjae.jeon@xxxxxxxxxxx> > > </corbet@xxxxxxx></chenhuacai@xxxxxxxxx></gibeomii.kim@xxxxxxxxxxx></stfrench@xxxxxxxxxxxxx></siyanteng@xxxxxxxxxxx></namjae.jeon@xxxxxxxxxxx>
