Received: by 2002:a25:8b12:0:0:0:0:0 with SMTP id i18csp2975687ybl; Mon, 19 Aug 2019 10:09:00 -0700 (PDT) X-Google-Smtp-Source: APXvYqxCROlc6WRzFlFGBa+PMqGlA7NZ9aHete/yjLW5Nl0F/JD8af4Xd4kOm7afWdV2Qdxaaqw3 X-Received: by 2002:a17:902:9698:: with SMTP id n24mr24366755plp.14.1566234540700; Mon, 19 Aug 2019 10:09:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1566234540; cv=none; d=google.com; s=arc-20160816; b=CgKto8VI4TDwHxqCaPZKaVJv//NHqRg+QK2oQUd1KIaDLPDT0rDcCLU1H763QsO14X /wnfaNbISTK7ptC4nfL76wrOU/LH6wqehPFIwyrRdeD3VuzjLIBcjOp0k+yE/4F5unyG d/6S6xA+qWctMCy+K0RyMkqsxa05hnK2B1Kg76bGasQHBwaG3AFTJzzPvy+RuqVZUJPO lZwEHXYtddFVo+4N3N2dylPwwzCZpNsTs3CWMIXngIkB3wUACBU1MombKD3N1ffMYV8q 29DvX0hYIPPCSdTns6xtFNB7W5XrrZZJPLn5AZ9zrBwb1WF7lYN2THxCE0HM7+JShGXu SeOA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-transfer-encoding:content-disposition:mime-version :references:message-id:subject:cc:to:from:date; bh=Of4oCvC84d5l0Van7TTl4vCmejPPHfHjxMKpW4hEU7Q=; b=GuU26KXPh+zy3aT6DW61zt2KDIkIrlnKsd9idvj6mbcy874M7HlyCvkfXjS5VrvcuD YQnHolp/4VVPv1wGtini6jWbQeWLDedrq32UQLk+1PyeeP219kd5eksd4eo8SgeS/+gU pZEqZjk8Wtu6KBJwo60n0zejK+ZPzrUuZTH25Jc3nUNTn2hrFUsRIMbre8iIDLREn/bi rDtMeQgGQ6j68nZXilIrDFKOawhbMzagdb7tppxNFLCS/g7GlfcHc8txNiqxgQQ/1d9D 5F3oFaqEaMt4cOvX7707hSAUl0FbLGROXqObsYHrRXcGPwZieOErWi46lQL9IsYOEXIC wQdQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id h16si10084187plr.94.2019.08.19.10.08.45; Mon, 19 Aug 2019 10:09:00 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728081AbfHSRHA (ORCPT + 99 others); Mon, 19 Aug 2019 13:07:00 -0400 Received: from asavdk4.altibox.net ([109.247.116.15]:36826 "EHLO asavdk4.altibox.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727354AbfHSRHA (ORCPT ); Mon, 19 Aug 2019 13:07:00 -0400 Received: from ravnborg.org (unknown [158.248.194.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by asavdk4.altibox.net (Postfix) with ESMTPS id 40225803D0; Mon, 19 Aug 2019 19:06:57 +0200 (CEST) Date: Mon, 19 Aug 2019 19:06:55 +0200 From: Sam Ravnborg 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 Subject: Re: [PATCH] drm/drv: Use // for comments in example code 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-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20190808163629.14280-1-j.neuschaefer@gmx.net> User-Agent: Mutt/1.10.1 (2018-07-13) X-CMAE-Score: 0 X-CMAE-Analysis: v=2.3 cv=VcLZwmh9 c=1 sm=1 tr=0 a=UWs3HLbX/2nnQ3s7vZ42gw==:117 a=UWs3HLbX/2nnQ3s7vZ42gw==:17 a=jpOVt7BSZ2e4Z31A5e1TngXxSK0=:19 a=8nJEP1OIZ-IA:10 a=VVlED5B4AAAA:8 a=FVAixOh6KRUHZqgu9kwA:9 a=wPNLvfGTeEIA:10 a=pHzHmUro8NiASowvMSCR:22 a=Ew2E2A-JSTLzCXPT_086:22 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.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