linux-kernel - Re: [PATCH v15 07/13] docs: counter: Document character device interface

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <f6930072-c487-a102-931c-53a79515d5fa@gmail.com>
Date:   Sun, 22 Aug 2021 11:03:38 +0900
From:   Akira Yokosawa <akiyks@...il.com>
To:     vilhelm.gray@...il.com
Cc:     jic23@...nel.org, linux-arm-kernel@...ts.infradead.org,
        linux-iio@...r.kernel.org, linux-kernel@...r.kernel.org,
        linux-stm32@...md-mailman.stormreply.com,
        Akira Yokosawa <akiyks@...il.com>
Subject: Re: [PATCH v15 07/13] docs: counter: Document character device
 interface

(dropped most CCs)

Hello William,

I spotted a minor error while browsing documentation updates.

On Sat, 21 Aug 2021 19:52:27 +0900, William Breathitt Gray wrote:
> On Sun, Aug 15, 2021 at 05:51:02PM +0100, Jonathan Cameron wrote:
>> On Mon,  9 Aug 2021 21:37:32 +0900
>> William Breathitt Gray <vilhelm.gray@...il.com> wrote:
...
>> > +
>> > +Counter events can be configured by users to report various Counter
>> > +data of interest. This can be conceptualized as a list of Counter
>> > +component read calls to perform. For example:
>> > +
>> > +        +-------------------------------------------------+

This needs to be:

              +------------------------+------------------------+

, so that the table structure can be properly recognized by Sphinx
(kernel-doc tool).

        Thanks, Akira

>> > +        | COUNTER_EVENT_OVERFLOW | COUNTER_EVENT_INDEX    |
>> > +        +========================+========================+
>> > +        | Channel 0              | Channel 0              |
>> > +        +------------------------+------------------------+
>> > +        | * Count 0              | * Signal 0             |
>> > +        | * Count 1              | * Signal 0 Extension 0 |
>> > +        | * Signal 3             | * Extension 4          |
>> > +        | * Count 4 Extension 2  +------------------------+
>> > +        | * Signal 5 Extension 0 | Channel 1              |
>> > +        |                        +------------------------+
>> > +        |                        | * Signal 4             |
>> > +        |                        | * Signal 4 Extension 0 |
>> > +        |                        | * Count 7              |
>> > +        +------------------------+------------------------+
>> > +