From mboxrd@z Thu Jan 1 00:00:00 1970 From: Sam Ravnborg Subject: Re: [PATCH] drm/drv: Use // for comments in example code Date: Mon, 19 Aug 2019 19:06:55 +0200 Message-ID: <20190819170655.GA27109@ravnborg.org> References: <20190808163629.14280-1-j.neuschaefer@gmx.net> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Return-path: Content-Disposition: inline In-Reply-To: <20190808163629.14280-1-j.neuschaefer@gmx.net> Sender: linux-kernel-owner@vger.kernel.org To: Jonathan =?iso-8859-1?Q?Neusch=E4fer?= Cc: dri-devel@lists.freedesktop.org, Maxime Ripard , linux-kernel@vger.kernel.org, David Airlie , Sean Paul List-Id: dri-devel@lists.freedesktop.org Hi Jonathan. Thanks for making this more readable in the html output. On Thu, Aug 08, 2019 at 06:36:28PM +0200, Jonathan Neuschäfer wrote: > This improves Sphinx output in two ways: > > - It avoids an unmatched single-quote ('), about which Sphinx complained: > > /.../Documentation/gpu/drm-internals.rst:298: > WARNING: Could not lex literal_block as "c". Highlighting skipped. > > An alternative approach would be to replace "can't" with a word that > doesn't have a single-quote. > > - It lets Sphinx format the comments in italics and grey, making the > code slightly easier to read. > > Signed-off-by: Jonathan Neuschäfer I got Acked-by from Daniel Vetter and has now applied this patch to drm-misc-next. It will show up in linux-next after the merge window. Sam