Received: by 10.213.65.68 with SMTP id h4csp345975imn; Fri, 6 Apr 2018 00:52:38 -0700 (PDT) X-Google-Smtp-Source: AIpwx4/Hc46qENPOsqixmT41WMTvRZJ+83QFOKr9r+fvK69P2GmJWWAD2EKH8OEW0AqSZCXhqwW4 X-Received: by 10.98.214.91 with SMTP id r88mr19647525pfg.8.1523001158238; Fri, 06 Apr 2018 00:52:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1523001158; cv=none; d=google.com; s=arc-20160816; b=IWrc8nCRkOQZgrr8TI5ajmZSARZYxVijc+2U1NOlimKS/3U9gBi1CZjnO9vDyNIF4S AWAe4Vb6KTHLpi2KXFX2jw4vhe/nAZi0trZbZ2ozSwXwTnf+ay7OnhoQCiyXiRnifBhH yXbNb2STuxInjgrFW/yixdblurs2qXje7jCwMXHHkzqzCW0aPTtiabdXezTN1SDAZM4w qUSwtGOx8VmgjBVo9ioaaO7woxEzekGJLGlWZIIQp8PiPuupAmrp2MOLCf5c2cVa06aR 20oqlPE7XHq7LS2sGMvUC1h3VhMlcCp5ooUYCYCtKUOeLCQ+6KNTA1JMnrr7Lt+va82L s72g== 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-disposition:mime-version:references:message-id:subject:cc :to:from:date:arc-authentication-results; bh=sG4DjUwIgqekSkQrq6CkpPuItM1i6ML785irJTaHJuk=; b=0xAKRcAm9c0NC+WgMbl25HWbfe7xEkIU56Hm+ABOM/TzRqq7HmbrhirTuQNoQIutjP iRWDx56M8hFI0KVKJ43j74e+cIzAYXWGcbyNTNces4L7e3vL1VHKB0JBueBTZ7tjT5P0 wpbNgJ31vrkClYVtfiLvKvNEuj2IXrg/7LWsmfZi/CKeNBsw1TCJZXyEnz5kxgMebZU3 PCPBii53GMOlZUNrS01YYCefwKAsgymHwBXayO/yoDxUZnajfqDTQRzi4AMcjgcSmne3 o6GYiZK4G2TEDsAmfXyFu3PDAfqMjDtepAYwpLZ8RhgYIbNXtY1AtbQdpevuInQCfSEf Q90Q== 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 g66si7577025pfa.257.2018.04.06.00.52.24; Fri, 06 Apr 2018 00:52:38 -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 S1751573AbeDFHvQ (ORCPT + 99 others); Fri, 6 Apr 2018 03:51:16 -0400 Received: from mga18.intel.com ([134.134.136.126]:46949 "EHLO mga18.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751089AbeDFHvN (ORCPT ); Fri, 6 Apr 2018 03:51:13 -0400 X-Amp-Result: UNSCANNABLE X-Amp-File-Uploaded: False Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by orsmga106.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 06 Apr 2018 00:51:13 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,414,1517904000"; d="scan'208";a="44579563" Received: from kuha.fi.intel.com ([10.237.72.189]) by fmsmga001.fm.intel.com with SMTP; 06 Apr 2018 00:51:10 -0700 Received: by kuha.fi.intel.com (sSMTP sendmail emulation); Fri, 06 Apr 2018 10:51:09 +0300 Date: Fri, 6 Apr 2018 10:51:09 +0300 From: Heikki Krogerus To: Masanari Iida Cc: linux-kernel@vger.kernel.org, linux-doc , Jonathan Corbet , Greg KH , linux-usb@vger.kernel.org Subject: Re: make xmldocs failed with error after 4.17 merge period Message-ID: <20180406075109.GA21589@kuha.fi.intel.com> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.9.2 (2017-12-15) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Apr 06, 2018 at 12:38:42PM +0900, Masanari Iida wrote: > After merge following patch during 4.17 merger period, > make xmldocs start to fail with error. > > [bdecb33af34f79cbfbb656661210f77c8b8b5b5f] > usb: typec: API for controlling USB Type-C Multiplexers > > Error messages. > reST markup error: > /home/iida/Repo/linux-2.6/Documentation/driver-api/usb/typec.rst:215: > (SEVERE/4) Unexpected section title or transition. > > ------------------------ > Documentation/Makefile:93: recipe for target 'xmldocs' failed > make[1]: *** [xmldocs] Error 1 > Makefile:1527: recipe for target 'xmldocs' failed > make: *** [xmldocs] Error 2 > > $ > > An ascii graphic in typec.rst cause the error. Thanks for the report. I'm going to propose that we fix this by marking the ascii art as comment: diff --git a/Documentation/driver-api/usb/typec.rst b/Documentation/driver-api/usb/typec.rst index feb31946490b..972c11bf4141 100644 --- a/Documentation/driver-api/usb/typec.rst +++ b/Documentation/driver-api/usb/typec.rst @@ -212,7 +212,7 @@ port drivers can use USB Role Class API with those. Illustration of the muxes behind a connector that supports an alternate mode: - ------------------------ +.. ------------------------ | Connector | ------------------------ | | I hope that works. Br, -- heikki