On Fri, 2022-09-30 at 20:41 +0700, Bagas Sanjaya wrote: > On 9/30/22 20:33, Jonathan Corbet wrote: > > > CET introduces Shadow Stack and Indirect Branch Tracking. > > > Shadow stack is > > > a secondary stack allocated from memory and cannot be directly > > > modified by > > > -applications. When executing a CALL instruction, the processor > > > pushes the > > > +applications. When executing a ``CALL`` instruction, the > > > processor pushes the > > > > Just to be clear, not everybody is fond of sprinkling lots of > > ``literal > > text`` throughout the documentation in this way. Heavy use of it > > will > > certainly clutter the plain-text file and can be a net negative > > overall. > > > > Actually there is a trade-off between semantic correctness and plain- > text > clarity. With regards to inline code samples (like identifiers), I > fall > into the former camp. But when I'm reviewing patches for which the > surrounding documentation go latter camp (leave code samples alone > without > markup), I can adapt to that style as long as it causes no warnings > whatsover. Thanks. Unless anyone has any objections, I think I'll take all these changes, except for the literal-izing of the instructions. They are not really being used as code samples in this case. Bagas, can you reply with your sign-off and I'll just apply it?