Re: [PATCH] doc: memory-barriers: reStructure Text

From: Peter Zijlstra
Date: Wed Jan 03 2018 - 18:48:45 EST


On Wed, Jan 03, 2018 at 03:04:36PM +0530, afzal mohammed wrote:
> Let PDF & HTML's be created out of memory-barriers Text by
> reStructuring.
>
> reStructuring done were,
> 1. Section headers modification, lower header case except start
> 2. Removal of manual index(contents section), since it now gets created
> automatically for html/pdf
> 3. Internal cross reference for easy navigation
> 4. Alignment adjustments
> 5. Strong emphasis made wherever there was emphasis earlier (through
> other ways), strong was chosen as normal emphasis showed in italics,
> which was felt to be not enough & strong showed it in bold
> 6. ASCII text & code snippets in literal blocks
> 7. Backquotes for inline instances in the paragraph's where they are
> expressed not in English, but in C, pseudo-code, file path etc.
> 8. Notes section created out of the earlier notes
> 9. Manual numbering replaced by auto-numbering
> 10.Bibliography (References section) made such that it can be
> cross-linked
>
> Signed-off-by: afzal mohammed <afzal.mohd.ma@xxxxxxxxx>

So I hate this rst crap with a passion, so NAK from me.