linux-kernel - Re: [PATCH v2 3/3] Documentation: Add real-time to core-api

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] [thread-next>] [day] [month] [year] [list]

Message-ID: <20250819080358.H9R_64I7@linutronix.de>
Date: Tue, 19 Aug 2025 10:03:58 +0200
From: Sebastian Andrzej Siewior <bigeasy@...utronix.de>
To: Jonathan Corbet <corbet@....net>
Cc: linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
	linux-rt-devel@...ts.linux.dev, Boqun Feng <boqun.feng@...il.com>,
	Clark Williams <clrkwllms@...nel.org>,
	Frederic Weisbecker <frederic@...nel.org>,
	Ingo Molnar <mingo@...hat.com>,
	John Ogness <john.ogness@...utronix.de>,
	Peter Zijlstra <peterz@...radead.org>,
	Steven Rostedt <rostedt@...dmis.org>,
	Thomas Gleixner <tglx@...utronix.de>,
	Valentin Schneider <vschneid@...hat.com>,
	Waiman Long <longman@...hat.com>, Will Deacon <will@...nel.org>
Subject: Re: [PATCH v2 3/3] Documentation: Add real-time to core-api

On 2025-08-18 10:16:41 [-0600], Jonathan Corbet wrote:
> Sebastian Andrzej Siewior <bigeasy@...utronix.de> writes:
> 
> One nit:
> 
> > diff --git a/Documentation/core-api/real-time/differences.rst b/Documentation/core-api/real-time/differences.rst
> > new file mode 100644
> > index 0000000000000..50d994a31e11c
> > --- /dev/null
> > +++ b/Documentation/core-api/real-time/differences.rst
> > @@ -0,0 +1,242 @@
> > +.. SPDX-License-Identifier: GPL-2.0
> > +
> > +========================
> > +Significant differences
> > +========================
> 
> That heading text will appear in various places, including in the
> rendering of your new index.rst file.  In such a setting, "significant
> differences" doesn't give a lot of information.  Something like "How
> realtime kernels differ" would be better, IMO.
> 
> Otherwise, this all looks good to me.  Did you want me to pick it up, or
> did you have another path in mind for this work?

Right now this is it. Do you update the text above as suggested or do
you want me to resend it?

> Thanks,
> 
> jon

Sebastian