* htmldocs: Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils]
@ 2026-02-02 19:45 kernel test robot
2026-02-02 21:57 ` Randy Dunlap
0 siblings, 1 reply; 3+ messages in thread
From: kernel test robot @ 2026-02-02 19:45 UTC (permalink / raw)
To: Jonathan Corbet; +Cc: oe-kbuild-all, linux-kernel, linux-doc
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 18f7fcd5e69a04df57b563360b88be72471d6b62
commit: 00d95fcc4dee66dfb6980de6f2973b32f973a1eb docs: kdoc: handle the obsolescensce of docutils.ErrorString()
date: 5 months ago
reproduce: (https://download.01.org/0day-ci/archive/20260202/202602022007.fALe9bGB-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/202602022007.fALe9bGB-lkp@intel.com/
All warnings (new ones prefixed by >>):
WARNING: No kernel-doc for file ./include/linux/tty_port.h
ERROR: Cannot find file ./include/linux/tty_port.h
WARNING: No kernel-doc for file ./include/linux/tty_port.h
ERROR: Cannot find file ./include/linux/tty_port.h
WARNING: No kernel-doc for file ./include/linux/tty_port.h
>> Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils]
ERROR: Cannot find file ./include/linux/tty.h
WARNING: No kernel-doc for file ./include/linux/tty.h
ERROR: Cannot find file ./include/linux/tty.h
WARNING: No kernel-doc for file ./include/linux/tty.h
ERROR: Cannot find file ./include/linux/tty.h
vim +65 Documentation/driver-api/tty/tty_port.rst
3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 61
3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 62 .. kernel-doc:: include/linux/tty_port.h
3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 63 :identifiers: tty_port
3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 64
3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 @65 ----
3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 66
:::::: The code at line 65 was first introduced by commit
:::::: 3f19fed8d0daed6e0e04b130d203d4333b757901 Documentation: add TTY chapter
:::::: TO: Jiri Slaby <jslaby@suse.cz>
:::::: CC: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: htmldocs: Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils]
2026-02-02 19:45 htmldocs: Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils] kernel test robot
@ 2026-02-02 21:57 ` Randy Dunlap
2026-02-06 2:29 ` Oliver Sang
0 siblings, 1 reply; 3+ messages in thread
From: Randy Dunlap @ 2026-02-02 21:57 UTC (permalink / raw)
To: kernel test robot, Jonathan Corbet; +Cc: oe-kbuild-all, linux-kernel, linux-doc
Hi k.t.r.,
On 2/2/26 11:45 AM, kernel test robot wrote:
> tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
> head: 18f7fcd5e69a04df57b563360b88be72471d6b62
> commit: 00d95fcc4dee66dfb6980de6f2973b32f973a1eb docs: kdoc: handle the obsolescensce of docutils.ErrorString()
> date: 5 months ago
> reproduce: (https://download.01.org/0day-ci/archive/20260202/202602022007.fALe9bGB-lkp@intel.com/reproduce)
I cannot reproduce this warning.
What version of docutils do you use?
> 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/202602022007.fALe9bGB-lkp@intel.com/
>
> All warnings (new ones prefixed by >>):
>
> WARNING: No kernel-doc for file ./include/linux/tty_port.h
> ERROR: Cannot find file ./include/linux/tty_port.h
> WARNING: No kernel-doc for file ./include/linux/tty_port.h
> ERROR: Cannot find file ./include/linux/tty_port.h
> WARNING: No kernel-doc for file ./include/linux/tty_port.h
>>> Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils]
> ERROR: Cannot find file ./include/linux/tty.h
> WARNING: No kernel-doc for file ./include/linux/tty.h
> ERROR: Cannot find file ./include/linux/tty.h
> WARNING: No kernel-doc for file ./include/linux/tty.h
> ERROR: Cannot find file ./include/linux/tty.h
>
>
> vim +65 Documentation/driver-api/tty/tty_port.rst
>
> 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 61
> 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 62 .. kernel-doc:: include/linux/tty_port.h
> 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 63 :identifiers: tty_port
> 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 64
> 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 @65 ----
> 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 66
>
> :::::: The code at line 65 was first introduced by commit
> :::::: 3f19fed8d0daed6e0e04b130d203d4333b757901 Documentation: add TTY chapter
>
> :::::: TO: Jiri Slaby <jslaby@suse.cz>
> :::::: CC: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
>
thanks.
--
~Randy
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: htmldocs: Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils]
2026-02-02 21:57 ` Randy Dunlap
@ 2026-02-06 2:29 ` Oliver Sang
0 siblings, 0 replies; 3+ messages in thread
From: Oliver Sang @ 2026-02-06 2:29 UTC (permalink / raw)
To: Randy Dunlap
Cc: kernel test robot, Jonathan Corbet, oe-kbuild-all, linux-kernel,
linux-doc, oliver.sang
hi, Randy Dunlap,
On Mon, Feb 02, 2026 at 01:57:46PM -0800, Randy Dunlap wrote:
> Hi k.t.r.,
>
> On 2/2/26 11:45 AM, kernel test robot wrote:
> > tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
> > head: 18f7fcd5e69a04df57b563360b88be72471d6b62
> > commit: 00d95fcc4dee66dfb6980de6f2973b32f973a1eb docs: kdoc: handle the obsolescensce of docutils.ErrorString()
> > date: 5 months ago
> > reproduce: (https://download.01.org/0day-ci/archive/20260202/202602022007.fALe9bGB-lkp@intel.com/reproduce)
>
> I cannot reproduce this warning.
> What version of docutils do you use?
Python version: 3.13.5
Docutils version: 0.21.2
Running Sphinx v8.2.3
BTW, though it's persistently reproduced by bot process, now we also run into
problems that it cannot be reproduced manually in a separate env.
now we're investigating the env difference. thanks
>
> > 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/202602022007.fALe9bGB-lkp@intel.com/
> >
> > All warnings (new ones prefixed by >>):
> >
> > WARNING: No kernel-doc for file ./include/linux/tty_port.h
> > ERROR: Cannot find file ./include/linux/tty_port.h
> > WARNING: No kernel-doc for file ./include/linux/tty_port.h
> > ERROR: Cannot find file ./include/linux/tty_port.h
> > WARNING: No kernel-doc for file ./include/linux/tty_port.h
> >>> Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils]
> > ERROR: Cannot find file ./include/linux/tty.h
> > WARNING: No kernel-doc for file ./include/linux/tty.h
> > ERROR: Cannot find file ./include/linux/tty.h
> > WARNING: No kernel-doc for file ./include/linux/tty.h
> > ERROR: Cannot find file ./include/linux/tty.h
> >
> >
> > vim +65 Documentation/driver-api/tty/tty_port.rst
> >
> > 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 61
> > 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 62 .. kernel-doc:: include/linux/tty_port.h
> > 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 63 :identifiers: tty_port
> > 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 64
> > 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 @65 ----
> > 3f19fed8d0daed Documentation/tty/tty_port.rst Jiri Slaby 2021-11-26 66
> >
> > :::::: The code at line 65 was first introduced by commit
> > :::::: 3f19fed8d0daed6e0e04b130d203d4333b757901 Documentation: add TTY chapter
> >
> > :::::: TO: Jiri Slaby <jslaby@suse.cz>
> > :::::: CC: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
> >
>
> thanks.
> --
> ~Randy
>
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2026-02-06 2:29 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-02-02 19:45 htmldocs: Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils] kernel test robot
2026-02-02 21:57 ` Randy Dunlap
2026-02-06 2:29 ` Oliver Sang
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox