Follow @Openwall on Twitter for new release announcements and other news
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Date: Wed, 24 May 2017 10:35:42 -0700
From: Kees Cook <>
To: Mauro Carvalho Chehab <>
Cc: Linux Doc Mailing List <>, 
	Mauro Carvalho Chehab <>, LKML <>, 
	Jonathan Corbet <>, David Woodhouse <>, 
	Brian Norris <>, 
	Boris Brezillon <>, Marek Vasut <>, 
	Richard Weinberger <>, Cyrille Pitchen <>, 
	Linux mtd <>, Emese Revfy <>, 
	"" <>
Subject: Re: [PATCH 23/31] gcc-plugins.txt: standardize document format

On Thu, May 18, 2017 at 6:22 PM, Mauro Carvalho Chehab
<> wrote:
> Each text file under Documentation follows a different
> format. Some doesn't even have titles!
> Change its representation to follow the adopted standard,
> using ReST markups for it to be parseable by Sphinx:
> - promote main title;
> - use the right markup for footnotes;
> - use bold markup for files name;
> - identify literal blocks;
> - add blank lines to avoid Sphinx to complain;
> - remove numeration from titles.
> Signed-off-by: Mauro Carvalho Chehab <>

Acked-by: Kees Cook <>

This should probably get moved under "Kernel API documentation" but
may need a new sub-category, maybe "instrumentation"? Things like
KASan could be put under that too.


Kees Cook
Pixel Security

Powered by blists - more mailing lists

Confused about mailing lists and their use? Read about mailing lists on Wikipedia and check out these guidelines on proper formatting of your messages.