Re: [sj:damon/next 110/118] htmldocs: Documentation/admin-guide/mm/damon/usage.rst:9: WARNING: Mismatch: both interpreted text role prefix and reference suffix. [docutils]

Re: [sj:damon/next 110/118] htmldocs: Documentation/admin-guide/mm/damon/usage.rst:9: WARNING: Mismatch: both interpreted text role prefix and reference suffix. [docutils]

[SeongJae Park]

On Sun, 04 Jan 2026 09:49:08 +0100 kernel test robot <lkp@intel.com> wrote:

> tree:   https://git.kernel.org/pub/scm/linux/kernel/git/sj/linux.git damon/next
> head:   28d3c5e02b31f08aa715cf01ead66c072a9c5d5a
> commit: 5ff971ba3599d1e5d6a1721a85d50969a3c270ca [110/118] Docs/admin-guide/mm/damon/usage: suggest use of DAMON modules
> reproduce: (https://download.01.org/0day-ci/archive/20260104/202601040942.MWKEmMKA-lkp@intel.com/reproduce)
> 
> If you fix the issue in a separate patch/commit (i.e. not just a new version of
> the same patch/commit), kindly add following tags
> | Reported-by: kernel test robot <lkp@intel.com>
> | Closes: https://lore.kernel.org/oe-kbuild-all/202601040942.MWKEmMKA-lkp@intel.com/
> 
> All warnings (new ones prefixed by >>):
> 
>    WARNING: No kernel-doc for file ./include/linux/pci.h
>    ERROR: Cannot find file ./include/linux/mod_devicetable.h
>    WARNING: No kernel-doc for file ./include/linux/mod_devicetable.h
>    ERROR: Cannot find file ./include/linux/bootconfig.h
>    WARNING: No kernel-doc for file ./include/linux/bootconfig.h
> >> Documentation/admin-guide/mm/damon/usage.rst:9: WARNING: Mismatch: both interpreted text role prefix and reference suffix. [docutils]
>    ERROR: Cannot find file ./include/linux/pstore_zone.h
>    ERROR: Cannot find file ./include/linux/pstore_zone.h
>    WARNING: No kernel-doc for file ./include/linux/pstore_zone.h
>    ERROR: Cannot find file ./include/linux/pstore_blk.h
>    ERROR: Cannot find file ./include/linux/pstore_blk.h

Thank you for this report!

> 
> 
> vim +9 Documentation/admin-guide/mm/damon/usage.rst
> 
>      8	
>    > 9	- *Special-purpose DAMON modules.*
>     10	  :ref:`This <damon_modules_special_purpose>`_ is for people who building,

The '_' at the end of the reference was the problem.  I just pushed a fix to
damon/next tree.


Thanks,
SJ

[...]