Re: [PATCH 2/2] lsmem: (man) correct the markup of column names, and improve some grammar

Karel Zak <[email protected]> Wed, 11 Mar 2026 13:27:03 +0100
Newsgroups org.kernel.vger.util-linux
Message-ID <d6fywjkl5vvef3uyshxi477fe6vtnzygb7sjsy5mecs7c546gd@cy73pfohzucq>
On Mon, Mar 09, 2026 at 01:36:32PM +0100, Sumanth Korikkar wrote:
> How about the following?
> Example STATE, CONFIGURED, MEMMAP-ON-MEMORY states:
> STATE   | CONFIGURED | MEMMAP-ON-MEMORY | Description
> online  | yes        | yes              | Memory block is configured with memmap-on-memory enabled and online.
> online  | yes        | no               | Memory block is configured with memmap-on-memory disabled and online.
> offline | yes        | yes              | Memory block is configured but currently offline.
> offline | no         | yes              | Memory block is deconfigured and was previously configured with memmap-on-memory.
> offline | no         | no               | Memory block is deconfigured and was not previously configured with memmap-on-memory.

I personally prefer structured information like lists or tables and
dislike large text blocks ;-) 

However, in this case, I'm not sure if the description adds anything,
as it repeats what is obvious from STATE, CONFIGURED, MEMMAP-ON-MEMORY
columns.

What I find relevant is "previously configured." Maybe add a sentence
stating that CONFIGURED and MEMMAP-ON-MEMORY for _offline_ blocks show
the previous setup.

Benno, what do you think?

    Karel
-- 
 Karel Zak  <[email protected]>
 http://karelzak.blogspot.com