Re: [PATCH net-next v4 16/16] Documentation: networking: Add timestamp related APIs to OA TC6 framework

On Mon, Jun 08, 2026 at 05:10:23AM +0000, Selvamani Rajagopal wrote:

quoted

Subject: RE: [PATCH net-next v4 16/16] Documentation: networking: Add timestamp
related APIs to OA TC6 framework

quoted

Hi,
These needs a few additional blank lines to avoid docs build warnings:

Will do. My bad that I didn't verify with make htmldocs after editing the file.

quoted

Documentation/networking/oa-tc6-framework.rst:554: WARNING: Explicit markup ends
without a blank line; unexpected unindent. [docutils]
Documentation/networking/oa-tc6-framework.rst:561: WARNING: Explicit markup ends
without a blank line; unexpected unindent. [docutils]
Documentation/networking/oa-tc6-framework.rst:566: WARNING: Explicit markup ends
without a blank line; unexpected unindent. [docutils]
Documentation/networking/oa-tc6-framework.rst:573: WARNING: Explicit markup ends
without a blank line; unexpected unindent. [docutils]

Randy,

Though I fixed the issues you pointed out, I couldn't reproduce this issue with either "make htmldocs" 
or with "sphinx-build" commands. 

Am I missing something with respect to how document generation/verification is done?

Try

files=$(git show --pretty="" --name-only HEAD)
./scripts/kernel-doc -Wall -none $files

This is what the CI system does.

     Andrew