Re: [PATCH] docs: kernel-doc.rst: move label "_kernel_doc" to top

[Wu XiangCheng <wu.xiangcheng@linux.dev>]

话说 Jonathan Corbet 于 2022-08-13 (六) 10:53:13 -0600 曰过：
> Wu XiangCheng <wu.xiangcheng@linux.dev> writes:
> 
> > From: Wu XiangCheng <bobwxc@email.cn>
> >
> > "_kernel_doc" label which should refer to the entire document was in the
> > middle, move it to top. Also fix zh translation.
> >
> > Fixes: 46347502b099 ("Restructure kernel-doc.rst")
> > Signed-off-by: Wu XiangCheng <bobwxc@email.cn>
> > ---
> >  Documentation/doc-guide/kernel-doc.rst                    | 3 ++-
> >  Documentation/translations/zh_CN/doc-guide/kernel-doc.rst | 3 ++-
> >  2 files changed, 4 insertions(+), 2 deletions(-)
> 
> Rather than do this, is there any reason to not just delete the label
> entirely?  If anything references it, it can just name the file instead.
> But, as it happens, it's not even referenced anywhere...

Emmm, it's referenced. Remember to remove prefix '_' when grep.
Would you like to transfer all below references to path style?

$git grep -n "<kernel_doc>"
Documentation/process/submit-checklist.rst:64:11) Include :ref:`kernel-doc <kernel_doc>` to document global  kernel APIs.
Documentation/process/submit-checklist.rst:67:    :ref:`kernel-doc <kernel_doc>` and fix any issues.
Documentation/translations/it_IT/process/submit-checklist.rst:69:11) Includete commenti :ref:`kernel-doc <kernel_doc>` per documentare API
Documentation/translations/it_IT/process/submit-checklist.rst:71:    verificare i commenti :ref:`kernel-doc <kernel_doc>` ed eventualmente
Documentation/translations/zh_CN/process/submit-checklist.rst:59:11) 包括 :ref:`kernel-doc <kernel_doc>` 内核文档以记录全局内核API。（静态函数
Documentation/translations/zh_CN/process/submit-checklist.rst:61:    :ref:`kernel-doc <kernel_doc>` 并修复任何问题。
Documentation/translations/zh_TW/process/submit-checklist.rst:62:11) 包括 :ref:`kernel-doc <kernel_doc>` 內核文檔以記錄全局內核API。（靜態函數
Documentation/translations/zh_TW/process/submit-checklist.rst:64:    :ref:`kernel-doc <kernel_doc>` 並修復任何問題。

Thanks,

-- 
Wu XiangCheng	0x32684A40BCA7AEA7