[PATCH] htmldocs: userspace-api/dma-buf-heaps.rst: fix block quote warning

Kriish Sharma posted 1 patch 2 months ago
There is a newer version of this series
Documentation/userspace-api/dma-buf-heaps.rst | 1 +
1 file changed, 1 insertion(+)
[PATCH] htmldocs: userspace-api/dma-buf-heaps.rst: fix block quote warning
Posted by Kriish Sharma 2 months ago
Fix the following warning encountered when running `make htmldocs`:

  Documentation/userspace-api/dma-buf-heaps.rst:29: WARNING: Block quote ends without a blank line; unexpected unindent

Added a blank line before the "Naming Convention" heading to comply with reST

Fixes: 1fdbb3ff1233 ("Add linux-next specific files for 20251015")
Signed-off-by: Kriish Sharma <kriish.sharma2006@gmail.com>
---
 Documentation/userspace-api/dma-buf-heaps.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Documentation/userspace-api/dma-buf-heaps.rst b/Documentation/userspace-api/dma-buf-heaps.rst
index a0979440d2a4..c0035dc257e0 100644
--- a/Documentation/userspace-api/dma-buf-heaps.rst
+++ b/Documentation/userspace-api/dma-buf-heaps.rst
@@ -26,6 +26,7 @@ following heaps:
    ``DMABUF_HEAPS_CMA_LEGACY`` Kconfig option is set, a duplicate node is
    created following legacy naming conventions; the legacy name might be
    ``reserved``, ``linux,cma``, or ``default-pool``.
+
 Naming Convention
 =================
 
-- 
2.34.1
Re: [PATCH] htmldocs: userspace-api/dma-buf-heaps.rst: fix block quote warning
Posted by Bagas Sanjaya 2 months ago
On Wed, Oct 15, 2025 at 06:34:02PM +0000, Kriish Sharma wrote:
> Fixes: 1fdbb3ff1233 ("Add linux-next specific files for 20251015")

The correct blamed fixes should've been:

Fixes: 507211e3c7a1 ("Documentation: dma-buf: heaps: Add naming guidelines")

Thanks.

-- 
An old man doll... just what I always wanted! - Clara
Re: [PATCH] htmldocs: userspace-api/dma-buf-heaps.rst: fix block quote warning
Posted by Kriish Sharma 2 months ago
Thanks for the review, Bagas.

I've sent a v2 with the corrected Fixes tag as you suggested:
https://lore.kernel.org/all/20251016020912.1653230-1-kriish.sharma2006@gmail.com/

Thanks,
Kriish


On Thu, Oct 16, 2025 at 5:31 AM Bagas Sanjaya <bagasdotme@gmail.com> wrote:
>
> On Wed, Oct 15, 2025 at 06:34:02PM +0000, Kriish Sharma wrote:
> > Fixes: 1fdbb3ff1233 ("Add linux-next specific files for 20251015")
>
> The correct blamed fixes should've been:
>
> Fixes: 507211e3c7a1 ("Documentation: dma-buf: heaps: Add naming guidelines")
>
> Thanks.
>
> --
> An old man doll... just what I always wanted! - Clara
Re: [PATCH] htmldocs: userspace-api/dma-buf-heaps.rst: fix block quote warning
Posted by Randy Dunlap 2 months ago

On 10/15/25 11:34 AM, Kriish Sharma wrote:
> Fix the following warning encountered when running `make htmldocs`:
> 
>   Documentation/userspace-api/dma-buf-heaps.rst:29: WARNING: Block quote ends without a blank line; unexpected unindent
> 
> Added a blank line before the "Naming Convention" heading to comply with reST
> 
> Fixes: 1fdbb3ff1233 ("Add linux-next specific files for 20251015")
> Signed-off-by: Kriish Sharma <kriish.sharma2006@gmail.com>

Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>

Thanks.

> ---
>  Documentation/userspace-api/dma-buf-heaps.rst | 1 +
>  1 file changed, 1 insertion(+)
> 
> diff --git a/Documentation/userspace-api/dma-buf-heaps.rst b/Documentation/userspace-api/dma-buf-heaps.rst
> index a0979440d2a4..c0035dc257e0 100644
> --- a/Documentation/userspace-api/dma-buf-heaps.rst
> +++ b/Documentation/userspace-api/dma-buf-heaps.rst
> @@ -26,6 +26,7 @@ following heaps:
>     ``DMABUF_HEAPS_CMA_LEGACY`` Kconfig option is set, a duplicate node is
>     created following legacy naming conventions; the legacy name might be
>     ``reserved``, ``linux,cma``, or ``default-pool``.
> +
>  Naming Convention
>  =================
>  

-- 
~Randy