linux-kernel - Re: htmldocs: Documentation/driver-api/tty/tty_port.rst:65: WARNING: Document or section may not begin with a transition. [docutils]

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <aYVSEOnbqsdc3Rha@xsang-OptiPlex-9020>
Date: Fri, 6 Feb 2026 10:29:36 +0800
From: Oliver Sang <oliver.sang@...el.com>
To: Randy Dunlap <rdunlap@...radead.org>
CC: kernel test robot <lkp@...el.com>, Jonathan Corbet <corbet@....net>,
	<oe-kbuild-all@...ts.linux.dev>, <linux-kernel@...r.kernel.org>,
	<linux-doc@...r.kernel.org>, <oliver.sang@...el.com>
Subject: Re: htmldocs: Documentation/driver-api/tty/tty_port.rst:65: WARNING:
 Document or section may not begin with a transition. [docutils]

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@...el.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@...e.cz>
> > :::::: CC: Greg Kroah-Hartman <gregkh@...uxfoundation.org>
> > 
> 
> thanks.
> -- 
> ~Randy
>