Re: [PATCH] Documentation: ABI: fix brackets and bracelets

From: Andy Shevchenko

Date: Thu Jun 11 2026 - 14:47:51 EST


On Thu, Jun 11, 2026 at 10:56:21AM +0200, Manuel Ebner wrote:
> Fix missing and needless brackets
> Fix missing bracelets

Please, use proper English punctuation.

...

> all VLs from this port. This may include packets with errors.
> This is 64 bit counter.

> + port_rcv_packets: (RO) Total number of packets, this may include
> + packets containing Errors. This is a 64 bit counter.

Side note: 64-bit (note a dash) is the standard form of telling the size of
the fixed-width values. Perhaps also update at some point?

...

> --- a/Documentation/ABI/testing/sysfs-firmware-dmi-entries
> +++ b/Documentation/ABI/testing/sysfs-firmware-dmi-entries
> @@ -93,7 +93,7 @@ Description:
> /sys/firmware/dmi/entries/15-0/system_event_log
>
> and has the following attributes (documented in the
> - SMBIOS / DMI specification under "System Event Log (Type 15)":
> + SMBIOS / DMI specification under "System Event Log (Type 15)"):

Probably similar approach as in the rest?

and has the following attributes, which is documented in the
SMBIOS / DMI specification under "System Event Log (Type 15)":

> - area_length
> - header_start_offset

--
With Best Regards,
Andy Shevchenko