All of lore.kernel.org
 help / color / mirror / Atom feed
From: Joe Perches <joe@perches.com>
To: Mauro Carvalho Chehab <mchehab@s-opensource.com>,
	Linux Doc Mailing List <linux-doc@vger.kernel.org>
Cc: "Mauro Carvalho Chehab" <mchehab@infradead.org>,
	"Markus Heiser" <markus.heiser@darmarit.de>,
	"Jonathan Corbet" <corbet@lwn.net>,
	"Jani Nikula" <jani.nikula@linux.intel.com>,
	LKML <linux-kernel@vger.kernel.org>,
	"Mauro Carvalho Chehab" <mchehab@kernel.org>,
	"Jean Delvare" <jdelvare@suse.de>,
	"Manuel Pégourié-Gonnard" <mpg@elzevir.fr>,
	"Thomas Gardner" <tmg@fastmail.com>
Subject: Re: [PATCH v2 05/20] docs-rst: CodingStyle.rst: Convert to ReST markup
Date: Mon, 12 Sep 2016 19:59:00 -0700	[thread overview]
Message-ID: <1473735540.11006.37.camel@perches.com> (raw)
In-Reply-To: <eb4e1f43c814bd1aefe3b0f45b686a331806edb4.1473732263.git.mchehab@s-opensource.com>

On Mon, 2016-09-12 at 23:17 -0300, Mauro Carvalho Chehab wrote:
> - Fix all chapter identation;
> - add c blocks where needed;

Assuming this is really useful and people agree with simple
conversions of .txt to .rst (and it does have some use),
there are a couple funky conversions

	if (condition)
		do_this();
	else
		do_that();

do_that() is oddly displayed in the code_block

and in the "Spaces" section, the pointer description is wrong

"\* is adjacent"

other than that, looks good to me.
> 

  reply	other threads:[~2016-09-13  2:59 UTC|newest]

Thread overview: 23+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-09-13  2:17 [PATCH v2 00/20] Create a book for Kernel development Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 01/20] docs-rst: move HOWTO and mentioned documents to a separate dir Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 02/20] docs-rst: HOWTO.rst: convert to ReST notation Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 03/20] docs-rst: applying-patches.rst: convert it to ReST markup Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 04/20] docs-rst: Changes.rst: " Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 05/20] docs-rst: CodingStyle.rst: Convert " Mauro Carvalho Chehab
2016-09-13  2:59   ` Joe Perches [this message]
2016-09-13  8:46     ` Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 06/20] CodingStyle.rst: use the proper tag for verbatim font Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 07/20] CodingStyle.rst: replace underline markups Mauro Carvalho Chehab
2016-09-13  2:17 ` [PATCH v2 08/20] CodingStyle.rst: use the .. note:: markup where needed Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 09/20] kernel-docs.rst: convert it to ReST markup Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 10/20] ManagementStyle.rst: " Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 11/20] SecurityBugs.rst: " Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 12/20] stable_api_nonsense.rst: " Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 13/20] stable_kernel_rules.rst: " Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 14/20] SubmittingDrivers.rst: " Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 15/20] SubmittingPatches.rst: " Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 16/20] HOWTO.rst: add cross-references to other documents Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 17/20] doc: development-process: rename files to rst Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 18/20] doc: development-process: convert it to ReST markup Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 19/20] doc: adjust references to development-process Mauro Carvalho Chehab
2016-09-13  2:18 ` [PATCH v2 20/20] doc: Add the development-process to Sphinx build Mauro Carvalho Chehab

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1473735540.11006.37.camel@perches.com \
    --to=joe@perches.com \
    --cc=corbet@lwn.net \
    --cc=jani.nikula@linux.intel.com \
    --cc=jdelvare@suse.de \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=markus.heiser@darmarit.de \
    --cc=mchehab@infradead.org \
    --cc=mchehab@kernel.org \
    --cc=mchehab@s-opensource.com \
    --cc=mpg@elzevir.fr \
    --cc=tmg@fastmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.