Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756707AbcKCJMh (ORCPT ); Thu, 3 Nov 2016 05:12:37 -0400 Received: from mga09.intel.com ([134.134.136.24]:2806 "EHLO mga09.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754226AbcKCJLt (ORCPT ); Thu, 3 Nov 2016 05:11:49 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.31,585,1473145200"; d="scan'208";a="781851974" From: Jani Nikula To: Markus Heiser , Mauro Carvalho Chehab Cc: Jonathan Corbet , Mauro Carvalho Chehab , Linux Doc Mailing List , Jim Davis , linux-kernel List Subject: Re: [PATCH RFC 0/4] Fix PDF build errors In-Reply-To: <1F43ABDB-381F-4AC8-8A72-AD0FCBE96DE0@darmarit.de> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <87lgx2jfq0.fsf@intel.com> <20161102104734.5c3b977e@vela.lan> <1F43ABDB-381F-4AC8-8A72-AD0FCBE96DE0@darmarit.de> Date: Thu, 03 Nov 2016 11:11:45 +0200 Message-ID: <87vaw5hqr2.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1049 Lines: 28 On Wed, 02 Nov 2016, Markus Heiser wrote: > Am 02.11.2016 um 17:47 schrieb Mauro Carvalho Chehab : >> I'm staring to think that we should just redefine the default for :: >> to be "none", and use the "C" handling **only** when explicitly >> requested. >> >> I remember that Jon did such suggestion sometime ago. > > *shrug* ... I think about kernel-doc comments in the sources, > mostly you will have small examples and won't those verbose > ".. code-block::" markup / using "::" keeps the comment compact. I sent the patch [1] to default to "none". It's never wrong, not even for code. But getting the highlighting wrong, OTOH, is pretty bad. We have that. And really, if you look at the kernel-doc comments and the rst documentation, we don't have all that many literal blocks that would benefit from syntax highlighting in the first place. BR, Jani. [1] http://lkml.kernel.org/r/1478164053-4562-1-git-send-email-jani.nikula@intel.com -- Jani Nikula, Intel Open Source Technology Center