From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Corbet Subject: Re: [PATCH 00/18] Fix some build warnings/errors with Sphinx Date: Tue, 8 May 2018 10:13:42 -0600 Message-ID: <20180508101342.2bde20ea@lwn.net> References: Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Mauro Carvalho Chehab Cc: linux-fbdev@vger.kernel.org, Linux Doc Mailing List , linux-iio@vger.kernel.org, Greg Kroah-Hartman , linux-pm@vger.kernel.org, linux-wireless@vger.kernel.org, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Mauro Carvalho Chehab , "Luis R. Rodriguez" , linux-mtd@lists.infradead.org, linux-crypto@vger.kernel.org, linux-can@vger.kernel.org List-Id: linux-can.vger.kernel.org T24gTW9uLCAgNyBNYXkgMjAxOCAwNjozNTozNiAtMDMwMApNYXVybyBDYXJ2YWxobyBDaGVoYWIg PG1jaGVoYWIrc2Ftc3VuZ0BrZXJuZWwub3JnPiB3cm90ZToKCj4gSSBkZWNpZGVkIHRvIGdpdmUg YSB0cnkgd2l0aCBTcGhpbnggbGFzdCBzdGFibGUgdmVyc2lvbgo+ICgxLjE3LjQpLCBhbmQgbm90 aWNlZCBzZXZlcmFsIGlzc3Vlcy4gVGhlIHdvcnNlIG9uZSB3YXMKPiB3aXRoIHRoZSBuZXR3b3Jr aW5nIGJvb2s6IGEgbm9uLXN0YW5kYXJkIGZvb3Rub3RlIHRoZXJlCj4gd2l0aCBbKl0gaW5zdGVh ZCBvZiBhIG51bWJlciBjYXVzZXMgaXQgdG8gYnJlYWsgUERGIGJ1aWxkaW5nLgo+IAo+IFNvLCBJ IHRvb2sgc29tZSBzcGFyZSB0aW1lIHRvIGFkZHJlc3Mgc29tZSB3YXJuaW5ncyBhbGwgb3Zlcgo+ IHRoZSB0cmVlLCBhbmQgbW92ZWQgYSBmZXcgdGV4dCBkb2N1bWVudHMgdG8gYSBib29rLiAKCk9L LCBJJ3ZlIGFwcGxpZWQgdGhlIG9uZXMgdGhhdCBzZWVtIHRvIG1ha2Ugc2Vuc2UgZm9yIG1lIHRv IHRha2Ugbm93LgpUaGVyZSdzIGNvbW1lbnRzIG9uIHRoZSBmaXJtd2FyZSBvbmUsIGFuZCBJJ2Qg cmF0aGVyIGhhdmUgVGVqdW4ncyBPSyBmb3IKdGhlIGNncm91cCBvbmUuICBUaGUgY29kZS1jb21t ZW50IGNoYW5nZXMgc2hvdWxkIHByb2JhYmx5IGdvIHZpYSB0aGUKdXN1YWwgbWFpbnRhaW5lcnMu Cgo+IEkgd2l0aAo+IEkgaGFkIG1vcmUgdGltZSB0byBtb3ZlIHRoZSBvdGhlciBvbmVzIGFuZCB0 byBzb2x2ZSBvdGhlcgo+IHdhcm5pbmdzLgoKWW91IGFuZCBtZSBib3RoIC0gYnV0IGVhY2ggc3Rl cCBoZWxwcyEKClRoYW5rcywKCmpvbgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fXwpkcmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVl ZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5m by9kcmktZGV2ZWwK 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=ham 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 49BB57DE74 for ; Tue, 8 May 2018 16:14:35 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755298AbeEHQNr (ORCPT ); Tue, 8 May 2018 12:13:47 -0400 Received: from ms.lwn.net ([45.79.88.28]:35952 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755237AbeEHQNq (ORCPT ); Tue, 8 May 2018 12:13:46 -0400 Received: from localhost.localdomain (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 7A635318; Tue, 8 May 2018 16:13:44 +0000 (UTC) Date: Tue, 8 May 2018 10:13:42 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org, linux-mtd@lists.infradead.org, linux-fbdev@vger.kernel.org, linux-can@vger.kernel.org, "Luis R. Rodriguez" , linux-iio@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-crypto@vger.kernel.org, Greg Kroah-Hartman , linux-pm@vger.kernel.org Subject: Re: [PATCH 00/18] Fix some build warnings/errors with Sphinx Message-ID: <20180508101342.2bde20ea@lwn.net> In-Reply-To: References: Organization: LWN.net X-Mailer: Claws Mail 3.15.1-dirty (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Mon, 7 May 2018 06:35:36 -0300 Mauro Carvalho Chehab wrote: > I decided to give a try with Sphinx last stable version > (1.17.4), and noticed several issues. The worse one was > with the networking book: a non-standard footnote there > with [*] instead of a number causes it to break PDF building. > > So, I took some spare time to address some warnings all over > the tree, and moved a few text documents to a book. OK, I've applied the ones that seem to make sense for me to take now. There's comments on the firmware one, and I'd rather have Tejun's OK for the cgroup one. The code-comment changes should probably go via the usual maintainers. > I with > I had more time to move the other ones and to solve other > warnings. You and me both - but each step helps! Thanks, jon -- 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 From: Jonathan Corbet Date: Tue, 08 May 2018 16:13:42 +0000 Subject: Re: [PATCH 00/18] Fix some build warnings/errors with Sphinx Message-Id: <20180508101342.2bde20ea@lwn.net> List-Id: References: In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: Mauro Carvalho Chehab Cc: linux-fbdev@vger.kernel.org, Linux Doc Mailing List , linux-iio@vger.kernel.org, Greg Kroah-Hartman , linux-pm@vger.kernel.org, linux-wireless@vger.kernel.org, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Mauro Carvalho Chehab , "Luis R. Rodriguez" , linux-mtd@lists.infradead.org, linux-crypto@vger.kernel.org, linux-can@vger.kernel.org On Mon, 7 May 2018 06:35:36 -0300 Mauro Carvalho Chehab wrote: > I decided to give a try with Sphinx last stable version > (1.17.4), and noticed several issues. The worse one was > with the networking book: a non-standard footnote there > with [*] instead of a number causes it to break PDF building. > > So, I took some spare time to address some warnings all over > the tree, and moved a few text documents to a book. OK, I've applied the ones that seem to make sense for me to take now. There's comments on the firmware one, and I'd rather have Tejun's OK for the cgroup one. The code-comment changes should probably go via the usual maintainers. > I with > I had more time to move the other ones and to solve other > warnings. You and me both - but each step helps! Thanks, jon From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ms.lwn.net ([45.79.88.28]:35952 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755237AbeEHQNq (ORCPT ); Tue, 8 May 2018 12:13:46 -0400 Date: Tue, 8 May 2018 10:13:42 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org, linux-mtd@lists.infradead.org, linux-fbdev@vger.kernel.org, linux-can@vger.kernel.org, "Luis R. Rodriguez" , linux-iio@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-crypto@vger.kernel.org, Greg Kroah-Hartman , linux-pm@vger.kernel.org Subject: Re: [PATCH 00/18] Fix some build warnings/errors with Sphinx Message-ID: <20180508101342.2bde20ea@lwn.net> In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Sender: linux-iio-owner@vger.kernel.org List-Id: linux-iio@vger.kernel.org On Mon, 7 May 2018 06:35:36 -0300 Mauro Carvalho Chehab wrote: > I decided to give a try with Sphinx last stable version > (1.17.4), and noticed several issues. The worse one was > with the networking book: a non-standard footnote there > with [*] instead of a number causes it to break PDF building. > > So, I took some spare time to address some warnings all over > the tree, and moved a few text documents to a book. OK, I've applied the ones that seem to make sense for me to take now. There's comments on the firmware one, and I'd rather have Tejun's OK for the cgroup one. The code-comment changes should probably go via the usual maintainers. > I with > I had more time to move the other ones and to solve other > warnings. You and me both - but each step helps! Thanks, jon