From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.8 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=unavailable autolearn_force=no version=3.4.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id 8FA907E27E for ; Wed, 25 Apr 2018 13:44:40 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753405AbeDYNoW (ORCPT ); Wed, 25 Apr 2018 09:44:22 -0400 Received: from mga06.intel.com ([134.134.136.31]:20331 "EHLO mga06.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753282AbeDYNoV (ORCPT ); Wed, 25 Apr 2018 09:44:21 -0400 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 25 Apr 2018 06:44:20 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.49,326,1520924400"; d="scan'208";a="49835824" Received: from jnikula-mobl2.fi.intel.com (HELO localhost) ([10.237.72.62]) by fmsmga001.fm.intel.com with ESMTP; 25 Apr 2018 06:44:18 -0700 From: Jani Nikula To: Heikki Krogerus , Greg KH , Jonathan Corbet Cc: Masanari Iida , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Markus Heiser , linux-usb@vger.kernel.org Subject: Re: [PATCH v2] Documentation: typec.rst: Use literal-block element with ascii art In-Reply-To: <20180406124122.70676-1-heikki.krogerus@linux.intel.com> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <20180406124122.70676-1-heikki.krogerus@linux.intel.com> Date: Wed, 25 Apr 2018 16:47:01 +0300 Message-ID: <87604fcsa2.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Fri, 06 Apr 2018, Heikki Krogerus wrote: > Using reStructuredText literal-block element with ascii-art. > That prevents the ascii art from being processed as > reStructuredText. > > Reported-by: Masanari Iida > Fixes: bdecb33af34f ("usb: typec: API for controlling USB Type-C Multiplexers") > Signed-off-by: Heikki Krogerus Jon, this fixes a documentation build failure in v4.17-rc1. It's not just a warning, it's a complete fail. Our docs builder at 01.org is failing, apparently the same at kernel.org. Please pick it up soon. Thanks, Jani. > --- > Changed since v1: > - Using literal-block element instead of comment > - Subject in v1 was "Documentation: typec.rst: Mark ascii art as a comment" > --- > Documentation/driver-api/usb/typec.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/driver-api/usb/typec.rst b/Documentation/driver-api/usb/typec.rst > index feb31946490b..48ff58095f11 100644 > --- a/Documentation/driver-api/usb/typec.rst > +++ b/Documentation/driver-api/usb/typec.rst > @@ -210,7 +210,7 @@ If the connector is dual-role capable, there may also be a switch for the data > role. USB Type-C Connector Class does not supply separate API for them. The > port drivers can use USB Role Class API with those. > > -Illustration of the muxes behind a connector that supports an alternate mode: > +Illustration of the muxes behind a connector that supports an alternate mode:: > > ------------------------ > | Connector | -- Jani Nikula, Intel Open Source Technology Center -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [v2] Documentation: typec.rst: Use literal-block element with ascii art From: Jani Nikula Message-Id: <87604fcsa2.fsf@intel.com> Date: Wed, 25 Apr 2018 16:47:01 +0300 To: Heikki Krogerus , Greg KH , Jonathan Corbet Cc: Masanari Iida , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Markus Heiser , linux-usb@vger.kernel.org List-ID: T24gRnJpLCAwNiBBcHIgMjAxOCwgSGVpa2tpIEtyb2dlcnVzIDxoZWlra2kua3JvZ2VydXNAbGlu dXguaW50ZWwuY29tPiB3cm90ZToKPiBVc2luZyByZVN0cnVjdHVyZWRUZXh0IGxpdGVyYWwtYmxv Y2sgZWxlbWVudCB3aXRoIGFzY2lpLWFydC4KPiBUaGF0IHByZXZlbnRzIHRoZSBhc2NpaSBhcnQg ZnJvbSBiZWluZyBwcm9jZXNzZWQgYXMKPiByZVN0cnVjdHVyZWRUZXh0Lgo+Cj4gUmVwb3J0ZWQt Ynk6IE1hc2FuYXJpIElpZGEgPHN0YW5kYnkyNHg3QGdtYWlsLmNvbT4KPiBGaXhlczogYmRlY2Iz M2FmMzRmICgidXNiOiB0eXBlYzogQVBJIGZvciBjb250cm9sbGluZyBVU0IgVHlwZS1DIE11bHRp cGxleGVycyIpCj4gU2lnbmVkLW9mZi1ieTogSGVpa2tpIEtyb2dlcnVzIDxoZWlra2kua3JvZ2Vy dXNAbGludXguaW50ZWwuY29tPgoKSm9uLCB0aGlzIGZpeGVzIGEgZG9jdW1lbnRhdGlvbiBidWls ZCBmYWlsdXJlIGluIHY0LjE3LXJjMS4gSXQncyBub3QKanVzdCBhIHdhcm5pbmcsIGl0J3MgYSBj b21wbGV0ZSBmYWlsLiBPdXIgZG9jcyBidWlsZGVyIGF0IDAxLm9yZyBpcwpmYWlsaW5nLCBhcHBh cmVudGx5IHRoZSBzYW1lIGF0IGtlcm5lbC5vcmcuIFBsZWFzZSBwaWNrIGl0IHVwIHNvb24uCgpU aGFua3MsCkphbmkuCgo+IC0tLQo+IENoYW5nZWQgc2luY2UgdjE6Cj4gLSBVc2luZyBsaXRlcmFs LWJsb2NrIGVsZW1lbnQgaW5zdGVhZCBvZiBjb21tZW50Cj4gLSBTdWJqZWN0IGluIHYxIHdhcyAi RG9jdW1lbnRhdGlvbjogdHlwZWMucnN0OiBNYXJrIGFzY2lpIGFydCBhcyBhIGNvbW1lbnQiCj4g LS0tCj4gIERvY3VtZW50YXRpb24vZHJpdmVyLWFwaS91c2IvdHlwZWMucnN0IHwgMiArLQo+ICAx IGZpbGUgY2hhbmdlZCwgMSBpbnNlcnRpb24oKyksIDEgZGVsZXRpb24oLSkKPgo+IGRpZmYgLS1n aXQgYS9Eb2N1bWVudGF0aW9uL2RyaXZlci1hcGkvdXNiL3R5cGVjLnJzdCBiL0RvY3VtZW50YXRp b24vZHJpdmVyLWFwaS91c2IvdHlwZWMucnN0Cj4gaW5kZXggZmViMzE5NDY0OTBiLi40OGZmNTgw OTVmMTEgMTAwNjQ0Cj4gLS0tIGEvRG9jdW1lbnRhdGlvbi9kcml2ZXItYXBpL3VzYi90eXBlYy5y c3QKPiArKysgYi9Eb2N1bWVudGF0aW9uL2RyaXZlci1hcGkvdXNiL3R5cGVjLnJzdAo+IEBAIC0y MTAsNyArMjEwLDcgQEAgSWYgdGhlIGNvbm5lY3RvciBpcyBkdWFsLXJvbGUgY2FwYWJsZSwgdGhl cmUgbWF5IGFsc28gYmUgYSBzd2l0Y2ggZm9yIHRoZSBkYXRhCj4gIHJvbGUuIFVTQiBUeXBlLUMg Q29ubmVjdG9yIENsYXNzIGRvZXMgbm90IHN1cHBseSBzZXBhcmF0ZSBBUEkgZm9yIHRoZW0uIFRo ZQo+ICBwb3J0IGRyaXZlcnMgY2FuIHVzZSBVU0IgUm9sZSBDbGFzcyBBUEkgd2l0aCB0aG9zZS4K PiAgCj4gLUlsbHVzdHJhdGlvbiBvZiB0aGUgbXV4ZXMgYmVoaW5kIGEgY29ubmVjdG9yIHRoYXQg c3VwcG9ydHMgYW4gYWx0ZXJuYXRlIG1vZGU6Cj4gK0lsbHVzdHJhdGlvbiBvZiB0aGUgbXV4ZXMg YmVoaW5kIGEgY29ubmVjdG9yIHRoYXQgc3VwcG9ydHMgYW4gYWx0ZXJuYXRlIG1vZGU6Ogo+ICAK PiAgICAgICAgICAgICAgICAgICAgICAgLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCj4gICAgICAg ICAgICAgICAgICAgICAgIHwgICAgICAgQ29ubmVjdG9yICAgICAgfAo= From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Google-Smtp-Source: AB8JxZorraJ1KCr+2IXpl6O2R6CNFXTcubT+hReziJLFtt4ichBvJcjEctmbuEqIRoWB6DEgzVlv ARC-Seal: i=1; a=rsa-sha256; t=1524663862; cv=none; d=google.com; s=arc-20160816; b=01O3czMKwhKZJ56fD7k0/hLY3Lhr9olPBV1fDN0EMmsAosMqAjl7axPh2p3ihSxhSB a0aMK3w5EGimgE0CcfgMQBUPXnRg9sOw+/h+d3zFIVs5bJd5twgdT7rORQNsHsEwj91R AM4XOex81a9unb47lSHJsYFPC+IY+MqZgOvo+KSuNgZxsz/qlrAIuTe7XNODKqa50PI1 VZLThUxzQVkIcS/RBl9nQ6lXZO+5ZMeKgqxnTagk5lpPYVOwa6Q2pjkg8gtUn9IWQAHZ 8aN0SrAjCbQVdxgag0Bc+n+71SgxH22S6zJTT429eycXOWazkHuLl8GS4Wv28e/zRBdJ jIog== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:message-id:date:references:organization:in-reply-to :subject:cc:to:from:arc-authentication-results; bh=1ec1dRmpMAE4GxdJhdbpAxO4XCcY+MMICLg2hOcEHgU=; b=PIP8JVkvXZcYron2FGv8kF7iiazMqoYu+MjJjWEnsFjTNNnJIwP8vjW1dfEDS1u+2D IHu+Efpl009VUrt8cGIGRU4m1Svme1PzQvkkX3bTVewV4FL/ZhS7PQa227PyZ8z7kafC rjsM68PGO5jS70myBKSCFgILSBvWv7aJrmx3qOqDbSaZBJH1vpNU+OtAT/3X5QSiWBll 0WVexT5qs2UL+ugVSb3XMp+/XdEB4MCO+rjx7YHxfrUsjVpquKkEJ0mGyeY4QTp3s75m ZYWkBFJ7XFbR0XKCwnV4sqOsMsdFGtI6seQdama1YFXi5jmFU5YCsMhNOXkd3MA2+TAl 45dQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of jani.nikula@intel.com designates 134.134.136.31 as permitted sender) smtp.mailfrom=jani.nikula@intel.com Authentication-Results: mx.google.com; spf=pass (google.com: domain of jani.nikula@intel.com designates 134.134.136.31 as permitted sender) smtp.mailfrom=jani.nikula@intel.com X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.49,326,1520924400"; d="scan'208";a="49835824" From: Jani Nikula To: Heikki Krogerus , Greg KH , Jonathan Corbet Cc: Masanari Iida , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Markus Heiser , linux-usb@vger.kernel.org Subject: Re: [PATCH v2] Documentation: typec.rst: Use literal-block element with ascii art In-Reply-To: <20180406124122.70676-1-heikki.krogerus@linux.intel.com> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <20180406124122.70676-1-heikki.krogerus@linux.intel.com> Date: Wed, 25 Apr 2018 16:47:01 +0300 Message-ID: <87604fcsa2.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: =?utf-8?q?1597000631976599018?= X-GMAIL-MSGID: =?utf-8?q?1598725933848538520?= X-Mailing-List: linux-kernel@vger.kernel.org List-ID: On Fri, 06 Apr 2018, Heikki Krogerus wrote: > Using reStructuredText literal-block element with ascii-art. > That prevents the ascii art from being processed as > reStructuredText. > > Reported-by: Masanari Iida > Fixes: bdecb33af34f ("usb: typec: API for controlling USB Type-C Multiplexers") > Signed-off-by: Heikki Krogerus Jon, this fixes a documentation build failure in v4.17-rc1. It's not just a warning, it's a complete fail. Our docs builder at 01.org is failing, apparently the same at kernel.org. Please pick it up soon. Thanks, Jani. > --- > Changed since v1: > - Using literal-block element instead of comment > - Subject in v1 was "Documentation: typec.rst: Mark ascii art as a comment" > --- > Documentation/driver-api/usb/typec.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/driver-api/usb/typec.rst b/Documentation/driver-api/usb/typec.rst > index feb31946490b..48ff58095f11 100644 > --- a/Documentation/driver-api/usb/typec.rst > +++ b/Documentation/driver-api/usb/typec.rst > @@ -210,7 +210,7 @@ If the connector is dual-role capable, there may also be a switch for the data > role. USB Type-C Connector Class does not supply separate API for them. The > port drivers can use USB Role Class API with those. > > -Illustration of the muxes behind a connector that supports an alternate mode: > +Illustration of the muxes behind a connector that supports an alternate mode:: > > ------------------------ > | Connector | -- Jani Nikula, Intel Open Source Technology Center