linux-doc.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] docs: ABI: sysfs-bus-nvdimm: fix unexpected indentation error
@ 2023-07-27 15:22 David Reaver
  2023-07-27 15:30 ` Jonathan Corbet
  0 siblings, 1 reply; 3+ messages in thread
From: David Reaver @ 2023-07-27 15:22 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Dave Jiang, Dan Williams, Jonathan Cameron, linux-kernel,
	linux-doc, David Reaver

Fix the following error when running make htmldocs:

Documentation/ABI/testing/sysfs-bus-nvdimm:10: ERROR: Unexpected indentation.

This is caused by missing newlines before the code examples. In particular,
before this patch, the second example for ctl_res_cnt doesn't render properly.

Link: https://docs.kernel.org/admin-guide/abi-testing.html#abi-sys-bus-event-source-devices-nmemx-format

Signed-off-by: David Reaver <me@davidreaver.com>
---
 Documentation/ABI/testing/sysfs-bus-nvdimm | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-bus-nvdimm b/Documentation/ABI/testing/sysfs-bus-nvdimm
index de8c5a59c77f..8564a0ff0d3e 100644
--- a/Documentation/ABI/testing/sysfs-bus-nvdimm
+++ b/Documentation/ABI/testing/sysfs-bus-nvdimm
@@ -18,7 +18,9 @@ Description:	(RO) Attribute group to describe the magic bits
 		Each attribute under this group defines a bit range of the
 		perf_event_attr.config. Supported attribute is listed
 		below::
+
 		  event  = "config:0-4"  - event ID

 		For example::
+
 			ctl_res_cnt = "event=0x1"

 What:           /sys/bus/event_source/devices/nmemX/events

^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [PATCH] docs: ABI: sysfs-bus-nvdimm: fix unexpected indentation error
  2023-07-27 15:22 [PATCH] docs: ABI: sysfs-bus-nvdimm: fix unexpected indentation error David Reaver
@ 2023-07-27 15:30 ` Jonathan Corbet
  2023-07-27 15:36   ` David Reaver
  0 siblings, 1 reply; 3+ messages in thread
From: Jonathan Corbet @ 2023-07-27 15:30 UTC (permalink / raw)
  To: David Reaver
  Cc: Dave Jiang, Dan Williams, Jonathan Cameron, linux-kernel,
	linux-doc, David Reaver

David Reaver <me@davidreaver.com> writes:

> Fix the following error when running make htmldocs:
>
> Documentation/ABI/testing/sysfs-bus-nvdimm:10: ERROR: Unexpected indentation.
>
> This is caused by missing newlines before the code examples. In particular,
> before this patch, the second example for ctl_res_cnt doesn't render properly.
>
> Link: https://docs.kernel.org/admin-guide/abi-testing.html#abi-sys-bus-event-source-devices-nmemx-format
>
> Signed-off-by: David Reaver <me@davidreaver.com>
> ---
>  Documentation/ABI/testing/sysfs-bus-nvdimm | 2 ++
>  1 file changed, 2 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-bus-nvdimm b/Documentation/ABI/testing/sysfs-bus-nvdimm
> index de8c5a59c77f..8564a0ff0d3e 100644
> --- a/Documentation/ABI/testing/sysfs-bus-nvdimm
> +++ b/Documentation/ABI/testing/sysfs-bus-nvdimm
> @@ -18,7 +18,9 @@ Description:	(RO) Attribute group to describe the magic bits
>  		Each attribute under this group defines a bit range of the
>  		perf_event_attr.config. Supported attribute is listed
>  		below::
> +
>  		  event  = "config:0-4"  - event ID
>
>  		For example::
> +
>  			ctl_res_cnt = "event=0x1"
>
>  What:           /sys/bus/event_source/devices/nmemX/events

Thanks for the patch.  This problem is already fixed in docs-next,
though, and thus in linux-next as well.

jon

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] docs: ABI: sysfs-bus-nvdimm: fix unexpected indentation error
  2023-07-27 15:30 ` Jonathan Corbet
@ 2023-07-27 15:36   ` David Reaver
  0 siblings, 0 replies; 3+ messages in thread
From: David Reaver @ 2023-07-27 15:36 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Dave Jiang, Dan Williams, Jonathan Cameron, linux-kernel,
	linux-doc


Jonathan Corbet <corbet@lwn.net> writes:

>
> Thanks for the patch.  This problem is already fixed in docs-next,
> though, and thus in linux-next as well.
>
> jon

Ah, sorry Jonathan. I was using Linus' tree, and I must have messed up
the search query I used against https://lore.kernel.org. I'll try to
remember to use docs-next for future docs patches.

Thanks,
David

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2023-07-27 15:38 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-07-27 15:22 [PATCH] docs: ABI: sysfs-bus-nvdimm: fix unexpected indentation error David Reaver
2023-07-27 15:30 ` Jonathan Corbet
2023-07-27 15:36   ` David Reaver

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).