Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753157AbdFSS63 (ORCPT ); Mon, 19 Jun 2017 14:58:29 -0400 Received: from mail-io0-f177.google.com ([209.85.223.177]:35781 "EHLO mail-io0-f177.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750985AbdFSS61 (ORCPT ); Mon, 19 Jun 2017 14:58:27 -0400 MIME-Version: 1.0 In-Reply-To: <956283e0d9f9c01a437ab75c5c9a324959ead132.1497713142.git.mchehab@s-opensource.com> References: <956283e0d9f9c01a437ab75c5c9a324959ead132.1497713142.git.mchehab@s-opensource.com> From: Kees Cook Date: Mon, 19 Jun 2017 11:58:24 -0700 X-Google-Sender-Auth: Wtvgyi3BeI4N1MoSlgqy1CXCk84 Message-ID: Subject: Re: [PATCH v2 22/31] gcc-plugins.txt: standardize document format To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , LKML , Jonathan Corbet , Emese Revfy , "kernel-hardening@lists.openwall.com" Content-Type: text/plain; charset="UTF-8" Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 761 Lines: 28 On Sat, Jun 17, 2017 at 8:25 AM, 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 Thanks! This should maybe get moved/indexed in dev-tools/. What do you think? Regardless: Acked-by: Kees Cook -Kees -- Kees Cook Pixel Security