Re: [PATCH v6 21/22] [RFC] Documentation: Add SCMI System Telemetry documentation

[Cristian Marussi <cristian.marussi@arm.com>]

On Fri, Jul 24, 2026 at 09:05:53AM -0600, Jonathan Corbet wrote:
> Cristian Marussi <cristian.marussi@arm.com> writes:
> 

Hi Jon,

thanks for having a look at this !

> > Document ARM SCMI Telemetry IOCTLs interface.
> >
> > Cc: Jonathan Corbet <corbet@lwn.net>
> > Cc: Shuah Khan <skhan@linuxfoundation.org>
> > Cc: linux-doc@vger.kernel.org
> > Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
> > ---
> > RFC since it still needs more extensive examples
> >
> > v5 --> v6
> >  - fixed typos
> > ---
> >  Documentation/userspace-api/index.rst |   1 +
> >  Documentation/userspace-api/stlm.rst  | 143 ++++++++++++++++++++++++++
> >  2 files changed, 144 insertions(+)
> >  create mode 100644 Documentation/userspace-api/stlm.rst
> >
> > diff --git a/Documentation/userspace-api/index.rst b/Documentation/userspace-api/index.rst
> > index a68b1bea57a8..22daa7ebf78e 100644
> > --- a/Documentation/userspace-api/index.rst
> > +++ b/Documentation/userspace-api/index.rst
> > @@ -54,6 +54,7 @@ Devices and I/O
> >     dcdbas
> >     vduse
> >     isapnp
> > +   stlm
> >  
> >  Everything else
> >  ===============
> > diff --git a/Documentation/userspace-api/stlm.rst b/Documentation/userspace-api/stlm.rst
> > new file mode 100644
> > index 000000000000..e34226b11373
> > --- /dev/null
> > +++ b/Documentation/userspace-api/stlm.rst
> > @@ -0,0 +1,143 @@
> > +.. SPDX-License-Identifier: GPL-2.0
> > +.. stlm:
> 
> I'm not sure what that last line is meant to be?  It *looks* like it's
> meant to be the sort of top-of-file label that I've been trying to get
> people to stop adding for years...but it lacks the leading underscore,
> and so won't work even for that.  Remove that line?
> 

Yes...my bad I was trying to badly mimicing from some other place...
I removed this in v7, but the Docs are still RFC (even in V7) since they
still lacks a lot more usage examples....I'll go for that in v8

Thanks,
Cristian