Re: [PATCH 0/4] Convert atomic_*.txt and memory-barriers.txt to reST

[Steven Rostedt]

On Thu, 17 Jul 2025 12:55:54 +0200
Peter Zijlstra <peterz@xxxxxxxxxxxxx> wrote:

> On Thu, Jul 17, 2025 at 03:06:13PM +0700, Bagas Sanjaya wrote:
> > Atomic types, atomic bitops, and memory barriers docs are included in kernel
> > docs build since commit e40573a43d163a ("docs: put atomic*.txt and
> > memory-barriers.txt into the core-api book") as a wrapper stub for
> > corresponding uncoverted txt docs. Let's turn them into full-fledged reST docs. 
> > 
> > Bagas Sanjaya (4):
> >   Documentation: memory-barriers: Convert to reST format
> >   Documentation: atomic_bitops: Convert to reST format
> >   Documentation: atomic_t: Convert to reST format
> >   Documentation: atomic_bitops, atomic_t, memory-barriers: Link to
> >     newly-converted docs  
> 
> NAK
> 
> If these are merged I will no longer touch / update these files.

One way a human discovers why something is the way it is, is to change it,
and see what the fallout is for that change.

  ;-)

-- Steve