Re: [PATCH v3 01/20] Documentation: locking: Describe seqlock design and usage

From: Jonathan Corbet
Date: Mon Jul 06 2020 - 17:12:47 EST


On Mon, 6 Jul 2020 23:04:39 +0200
Peter Zijlstra <peterz@xxxxxxxxxxxxx> wrote:

> On Tue, Jun 30, 2020 at 07:44:33AM +0200, Ahmed S. Darwish wrote:
> > +Sequence counters (:c:type:`seqcount_t`)
> > +========================================
>
> > +.. code-block:: c
>
> I so hate RST, of course it's C. Also, ISTR Jon saying you can leave
> that all out without issue.

The "c" enables keyword coloring and such - something I can happily do
without but others seem to care about it. If you take out that line,
though, you'll need a "::" at least to start a literal block.

jon