2018-02-19 13:57:12

by Masanari Iida

[permalink] [raw]
Subject: [PATCH] linux-next: SLIMbus: doc: Fix a warning "Title underline too short"

This patch fixes a warning during "make xmldocs"

Documentation/driver-api/slimbus.rst:93:
WARNING: Title underline too short.

Signed-off-by: Masanari Iida <[email protected]>
---
Documentation/driver-api/slimbus.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/driver-api/slimbus.rst b/Documentation/driver-api/slimbus.rst
index 7555ecd538de..a97449cf603a 100644
--- a/Documentation/driver-api/slimbus.rst
+++ b/Documentation/driver-api/slimbus.rst
@@ -90,7 +90,7 @@ controller resets the bus. This notification allows the driver to take necessary
steps to boot the device so that it's functional after the bus has been reset.

Driver and Controller APIs:
---------------------------
+---------------------------
.. kernel-doc:: include/linux/slimbus.h
:internal:

--
2.16.2.246.ga4ee44448fe9



2018-02-19 14:14:07

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] linux-next: SLIMbus: doc: Fix a warning "Title underline too short"

On Mon, 19 Feb 2018 22:55:50 +0900
Masanari Iida <[email protected]> wrote:

> This patch fixes a warning during "make xmldocs"
>
> Documentation/driver-api/slimbus.rst:93:
> WARNING: Title underline too short.
>
> Signed-off-by: Masanari Iida <[email protected]>

Applied, thanks.

jon

2018-02-19 14:33:54

by Matthew Wilcox

[permalink] [raw]
Subject: Re: [PATCH] linux-next: SLIMbus: doc: Fix a warning "Title underline too short"

On Mon, Feb 19, 2018 at 10:55:50PM +0900, Masanari Iida wrote:
> Driver and Controller APIs:
> ---------------------------
> +---------------------------
> .. kernel-doc:: include/linux/slimbus.h

Is this the right fix? Shouldn't we rather delete the : instead?
We don't normally have a colon at the end of subsection titles.

2018-02-26 04:23:44

by Randy Dunlap

[permalink] [raw]
Subject: Re: [PATCH] linux-next: SLIMbus: doc: Fix a warning "Title underline too short"

On 02/19/2018 06:32 AM, Matthew Wilcox wrote:
> On Mon, Feb 19, 2018 at 10:55:50PM +0900, Masanari Iida wrote:
>> Driver and Controller APIs:
>> ---------------------------
>> +---------------------------
>> .. kernel-doc:: include/linux/slimbus.h
>
> Is this the right fix? Shouldn't we rather delete the : instead?
> We don't normally have a colon at the end of subsection titles.

Agreed -- no ending colon.

--
~Randy