From patchwork Wed May 22 20:50:26 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 164892 Delivered-To: patch@linaro.org Received: by 2002:a92:9e1a:0:0:0:0:0 with SMTP id q26csp1328210ili; Wed, 22 May 2019 13:50:58 -0700 (PDT) X-Google-Smtp-Source: APXvYqyDBLya+fCtlw2OTcp60G4oAq/bBtvXgkJNawaDoLh8sxefUbjG2PFg8HCYI4XGbD8U7Bp9 X-Received: by 2002:a62:2706:: with SMTP id n6mr19444010pfn.150.1558558258402; Wed, 22 May 2019 13:50:58 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1558558258; cv=none; d=google.com; s=arc-20160816; b=xhSbFtoLNhkV+dO0NS6P60GZk0nMTen8GS0lFPaA53mZfcqD3U59BuNK5X5QqKqkGc Z3TS9cGtJWYTScV/579b81qoAO0OYnbun8waWX/jBlFpfo/tJIdUziYvRyB9vGvcDLrV 45gIiCBdCFA6IlEMvCxzwqdUoWl183iJshSvJQ+eoSLu0SMkWwbOSC0d+7w1Wk9y2Tfw fjc5v0im+IlesuUBHaF6ABM6fHs+xUojyU347/Y/+g3ttYqcrxG/bEiomV5/ps50mBlq DCzzZ9TqmEbQdtNbbt9So3fZAiuSpMvXEOv9fbc675V7GEW8datizdy8z0Ep6wrm9x0a +D/Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=vji8bfiVBCR+HXLGKAvkEiVVQuzP8In8vyRZB4Jws/Q=; b=GYESrDDiAXOyEjzW7bG9geX0910YSxx/lQT/YNEVxiaIEE0Fv7lmoN71xyqZWqpsec M+QplVFqS1mrimWtY7PQxte4Ltcbt9vKD5LR6zYnQh3iU3HT2LUTtE4cmYOvyCFP8AF/ wzMVyCPWQ8Ul6BXMXjQajREEiGJIqZM3OH9msMc9TS5I5rpPJE1hpxUEhJNKb8lBb1KR SfQVF+1KrXH8ZXPSB9GVvlL86i1OcZnr4oS/4np+K9CIjUJbYmR8TNJDOLV/sz66tg8U cwtKp/0c1TydgtpfHJ63wgnPu4EPep4Y51js5WpgRvjYES8idG/ja/yS0Yc4vREqXIGU 3K1w== 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 h4si2958833plb.206.2019.05.22.13.50.58; Wed, 22 May 2019 13:50:58 -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 S1730226AbfEVUu5 (ORCPT + 30 others); Wed, 22 May 2019 16:50:57 -0400 Received: from ms.lwn.net ([45.79.88.28]:49310 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729848AbfEVUu4 (ORCPT ); Wed, 22 May 2019 16:50:56 -0400 Received: from meer.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id 02180AAB; Wed, 22 May 2019 20:50:55 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Jani Nikula , Markus Heiser , Mauro Carvalho Chehab , Oleksandr Natalenko , Jonathan Corbet Subject: [PATCH 0/8] docs: Fixes for recent versions of Sphinx Date: Wed, 22 May 2019 14:50:26 -0600 Message-Id: <20190522205034.25724-1-corbet@lwn.net> X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The Sphinx folks deprecated some interfaces in the 2.0 release; one immediate result of that is a bunch of warnings that show up when building with 1.8. These two patches make those warnings go away, but at a cost: - It introduces a couple of Sphinx version checks, which are always ugly, but the alternative would be to stop supporting versions before 1.7. For now, I think we can carry that cruft. - The second patch causes the build to fail horribly on newer Sphinx installations. The change to switch_source_input() seems to make the parser much more finicky, increasing warnings and eventually failing the build altogether. In particular, it will scream about problems in .rst files that are not included in the TOC tree at all. This version of the patch set fixes up the worst problems (the i915 error in particular, which breaks the build hard). I've tested it with versions 1.4, 1.8, and 2.0. Given that these problems are already breaking builds on some systems, I think I may try to sell these changes to Linus for 5.2 still. Changes since v1: - Fix up a couple of logging changes I somehow missed - Don't save state when using switch_source_input() - Fix a few build errors - Add Mauro's sphinx-pre-install improvements Jonathan Corbet (7): doc: Cope with Sphinx logging deprecations doc: Cope with the deprecation of AutoReporter docs: fix numaperf.rst and add it to the doc tree lib/list_sort: fix kerneldoc build error docs: fix multiple doc build warnings in enumeration.rst docs/gpu: fix a documentation build break in i915.rst docs: Fix conf.py for Sphinx 2.0 Mauro Carvalho Chehab (1): scripts/sphinx-pre-install: make it handle Sphinx versions Documentation/admin-guide/mm/index.rst | 1 + Documentation/admin-guide/mm/numaperf.rst | 2 +- Documentation/conf.py | 2 +- .../firmware-guide/acpi/enumeration.rst | 2 +- Documentation/gpu/i915.rst | 4 +- Documentation/sphinx/kerneldoc.py | 44 +++++++--- Documentation/sphinx/kernellog.py | 28 +++++++ Documentation/sphinx/kfigure.py | 40 +++++---- lib/list_sort.c | 3 +- scripts/sphinx-pre-install | 81 +++++++++++++++++-- 10 files changed, 166 insertions(+), 41 deletions(-) create mode 100644 Documentation/sphinx/kernellog.py -- 2.21.0