Re: [PATCH v1] Documentation/admin-guide/perf: Fix indentation and formatting in fujitsu_uncore_pmu.rst

Re: [PATCH v1] Documentation/admin-guide/perf: Fix indentation and formatting in fujitsu_uncore_pmu.rst

[Bagas Sanjaya]

[-- Attachment #1: Type: text/plain, Size: 604 bytes --]

On Tue, Sep 30, 2025 at 10:07:36AM +0000, Swaraj Gaikwad wrote:
> This patch fixes several reStructuredText (RST) formatting issues in
> documentation/admin-guide/perf/fujitsu_uncore_pmu.rst that were causing
> Sphinx build warnings and errors. Specifically:
> 
> - Unexpected indentation in bullet lists.
> - Block-quote unindents that broke literal blocks.
> - Missing blank lines between paragraphs and lists.

Already fixed by [1].

Thanks.

[1]: https://lore.kernel.org/lkml/20250926043748.3785-1-krishnagopi487@gmail.com/

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

[PATCH v1] Documentation/admin-guide/perf: Fix indentation and formatting in fujitsu_uncore_pmu.rst

[Swaraj Gaikwad]

This patch fixes several reStructuredText (RST) formatting issues in
documentation/admin-guide/perf/fujitsu_uncore_pmu.rst that were causing
Sphinx build warnings and errors. Specifically:

- Unexpected indentation in bullet lists.
- Block-quote unindents that broke literal blocks.
- Missing blank lines between paragraphs and lists.

Reason for the patch:
Without these fixes, running `make docs` for the perf documentation
would produce warnings like "Unexpected indentation" and "Block quote
unindented", and could lead to incorrectly rendered documentation.
This patch ensures proper formatting and readability of the fujitsu_uncore_pmu
documentation, which is important for developers and users referencing
PMU events.

Changes made:
- Added blank lines between introductory text and bullet lists.
- Used double colon `::` for literal blocks.
- Adjusted indentation of list items and surrounding text.

Testing:
- Verified `make htmldocs` runs without emitting indentation or block-quote warnings after applying the patch.

Signed-off-by: Swaraj Gaikwad <swarajgaikwad1925@gmail.com>
---
 Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst b/Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst
index 46595b788d3a..31e6e535d11b 100644
--- a/Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst
+++ b/Documentation/admin-guide/perf/fujitsu_uncore_pmu.rst
@@ -14,16 +14,21 @@ pci_iod<iod>_pci<pci>.
 The driver provides a description of its available events and configuration
 options in sysfs, see /sys/bus/event_sources/devices/mac_iod<iod>_mac<mac>_ch<ch>/
 and /sys/bus/event_sources/devices/pci_iod<iod>_pci<pci>/.
+
 This driver exports:
+
 - formats, used by perf user space and other tools to configure events
 - events, used by perf user space and other tools to create events
-  symbolically, e.g.:
+  symbolically, e.g.::
+
     perf stat -a -e mac_iod0_mac0_ch0/event=0x21/ ls
     perf stat -a -e pci_iod0_pci0/event=0x24/ ls
+
 - cpumask, used by perf user space and other tools to know on which CPUs
   to open the events

 This driver supports the following events for MAC:
+
 - cycles
   This event counts MAC cycles at MAC frequency.
 - read-count
@@ -69,7 +74,6 @@ This driver supports the following events for MAC:
   This event counts the number of write requests from MAC to memory.
 - ea-ha
   This event counts energy consumption of HA.
-
   'ea' is the abbreviation for 'Energy Analyzer'.

 Examples for use with perf::
@@ -77,6 +81,7 @@ Examples for use with perf::
   perf stat -e mac_iod0_mac0_ch0/ea-mac/ ls

 And, this driver supports the following events for PCI:
+
 - pci-port0-cycles
   This event counts PCI cycles at PCI frequency in port0.
 - pci-port0-read-count
@@ -99,7 +104,6 @@ And, this driver supports the following events for PCI:
   This event counts write transactions for bus usage in port1.
 - ea-pci
   This event counts energy consumption of PCI.
-
   'ea' is the abbreviation for 'Energy Analyzer'.

 Examples for use with perf::
--
2.51.0