From patchwork Tue Mar 5 17:21:27 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Maydell X-Patchwork-Id: 159697 Delivered-To: patch@linaro.org Received: by 2002:a02:5cc1:0:0:0:0:0 with SMTP id w62csp5218861jad; Tue, 5 Mar 2019 09:23:17 -0800 (PST) X-Google-Smtp-Source: APXvYqymQKY8ayK/ekZqV54lc5f9YgqXh35Khix6TPbjRuKyGnEI2Mb4gF7RUeggsxo04bioIUFz X-Received: by 2002:a0d:edc3:: with SMTP id w186mr1894597ywe.301.1551806597282; Tue, 05 Mar 2019 09:23:17 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1551806597; cv=none; d=google.com; s=arc-20160816; b=YoV/lwL/Pxs2/fIgXRiCl5436w9pMU0mHyw8z/OmQaqA373h44H6oMzSnQBeAPLjOL cY4Vjsv3MQFRWehhLDaZPAZiKiDhNzAckda7gxU24w/qCO6dV9AWLHptTMZCU41lxP9B Tp+ukuBM6RJ74wni3pnVjEIizg3HgvtyHUOgSXRl55DulZkyiw+S5H4nSg9rO05PfWxq Sm0Pp/YbGMnGTFy0ctVHRgLVSJ9ieZ+lB9RtCdL3wW8iJirpM1Hkf+1lpyIHEgMVDMj6 pR0vqNt6AB7CZZKvDKPYfMye6B+VHclx8irNpS+SihrbAKjSrDFkwmk20JHHm6vYMjkl wBXQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:cc:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject :content-transfer-encoding:mime-version:message-id:date:to:from :dkim-signature; bh=xMPmg+pzsUUd/JpvokWyKETdO8Tu1hHFdnRbDoVemew=; b=uBL1hW/GPTjQfYj/acJSAYqakpS06I6T2gL3OReR7ipEak4a8WHSuwWNSYWX9ib1EG 3n8rvZTGEkykMMguHJhgtGe7ge440d7Vp0yB4jmJ+UJZnV6dLni/s32IcGNj0H6mDOzD IFlrU2/dF5Fp27ioDayzg9IQvkdTi9NluIdBOWmBmXZul7Hr4gpc7zEWOhcn77acu+At +MHpwKFZ5sXJVossRMktgrx303IuqTmXxYo+6H5E3vpLUZEif1Hkd0gkc3Bo9Cx+t+0w CrJ4Du1u2k7qS/ED2Cb0S87hLEO9EexXu4mG6EPb/Fr3tpK8lbLDJ1ms+yMq4eJQ/GKU KL/Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=YpAuFC8d; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id t80si5276370ywc.83.2019.03.05.09.23.16 for (version=TLS1 cipher=AES128-SHA bits=128/128); Tue, 05 Mar 2019 09:23:17 -0800 (PST) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=YpAuFC8d; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([127.0.0.1]:46413 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h1Dme-0002y0-3W for patch@linaro.org; Tue, 05 Mar 2019 12:23:16 -0500 Received: from eggs.gnu.org ([209.51.188.92]:35467) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h1DlB-00025l-M9 for qemu-devel@nongnu.org; Tue, 05 Mar 2019 12:21:46 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h1DlA-0000LK-DD for qemu-devel@nongnu.org; Tue, 05 Mar 2019 12:21:45 -0500 Received: from mail-wm1-x336.google.com ([2a00:1450:4864:20::336]:51257) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h1Dl9-0000EV-W8 for qemu-devel@nongnu.org; Tue, 05 Mar 2019 12:21:44 -0500 Received: by mail-wm1-x336.google.com with SMTP id n19so3357982wmi.1 for ; Tue, 05 Mar 2019 09:21:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=xMPmg+pzsUUd/JpvokWyKETdO8Tu1hHFdnRbDoVemew=; b=YpAuFC8dzfFSj5j0qBy0bg7YysJvBf8Vaq+hL/bltonMVyAPKKgZFwAQaPcsQTHUUS L13KaKqeeQrbEN7JwqGY3bE7bkNtbX9879WfXy0sSzdJV1951Bq+XfbPvdLZ/DtypKZp gwnyQ6tndvVysuM0OQg2ti+pdPST5k61OI8W2/a2+meFvHan61gyNz7ZnVYypLHPyUfM nXKpzSBpH8n6ajazubINaofTnnDpy/B8lh7kZ0e/bijIKu8CxI8QFKFAdnsCQo99ZxaB //hnXYdqKOrFyVT4Df+xnVS5MiBY9jgOYPdw4vS5s5p0I5+/yNAgWSOL9QCodyMPZHHZ WMGA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=xMPmg+pzsUUd/JpvokWyKETdO8Tu1hHFdnRbDoVemew=; b=VE798sA+NxoFSUKjO+zZZLlA0Y0yAVl0PfTu2+zQAOOVZf1RA1/BkHYtGDw0Pi9/o7 IHT3435OIn7+NFHgGF8G873S1JNBT+g7Nyln9BXP/+CevtgjiIOrxVpgTdq9XJKjf0ob qCSMi7FJMTGeyK+9bAa9B1X05OmHAkN/PeoRjBvvXqAY6d7mivspnt1m57J8aQZUpA1i k85/Z1aISc5dL+HZi8TgoMf/pd/so7frNVUyeEyYGx0H5l1P3CnASOponKwsdGWmjtky rqxLSiDYnLHa67GipBf1XKlztxigWubbbC6nYivFhdKDiIM1ESsfqrIpWrse8YTEaauX uESA== X-Gm-Message-State: APjAAAVbG2h+unoCS2d5j12DsPFVynYZ1ztfD1FH7DqlLgPBFYg4QOro /z7oox+8vWl+ABZbnhll7uorVvN9cPw= X-Received: by 2002:a1c:1d56:: with SMTP id d83mr3558539wmd.67.1551806502222; Tue, 05 Mar 2019 09:21:42 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id b195sm48289wmg.36.2019.03.05.09.21.40 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 05 Mar 2019 09:21:40 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Date: Tue, 5 Mar 2019 17:21:27 +0000 Message-Id: <20190305172139.32662-1-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::336 Subject: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: =?utf-8?q?Alex_Benn=C3=A9e?= , =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= , Aleksandar Markovic Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" This patchset enables building and installing the various rST docs we have started to accumulate in our docs/ directory. Version 3 is almost the same as version 2: the only differences are: * patch 5 enabling the Alabaster theme also adds "needs_sphinx = '1.3'" to docs/conf.py, since that is where the Alabaster theme was added to Sphinx proper * patch 9 has a new has_sphinx_build() function which specifically tests that sphinx-build can handle our conf.py, rather than just testing the executable is present * patch 9 adds /.doctrees to the .gitignore * patch 12 is new and provides a MAINTAINERS entry for the conf.py files (ie the build infrastructure, as distinct from the content) I figured the changes in patches 5 and 9 were small enough that I've kept the various reviewed/tested/etc tags. thanks -- PMM Peter Maydell (12): docs/cpu-hotplug.rst: Fix rST markup issues docs: Convert memory.txt to rst format docs: Commit initial files from sphinx-quickstart docs/conf.py: Disable unused _static directory docs/conf.py: Configure the 'alabaster' theme docs/conf.py: Don't include rST sources in HTML build docs/conf.py: Disable option warnings docs: Provide separate conf.py for each manual we want Makefile, configure: Support building rST documentation Makefile: Abstract out "identify the pkgversion" code docs/conf.py: Don't hard-code QEMU version MAINTAINERS: Add entry for Sphinx documentation infrastructure configure | 15 +- Makefile | 78 +++++++--- .gitignore | 1 + MAINTAINERS | 6 + docs/conf.py | 216 ++++++++++++++++++++++++++ docs/cpu-hotplug.rst | 2 +- docs/devel/conf.py | 15 ++ docs/devel/index.rst | 21 +++ docs/devel/{memory.txt => memory.rst} | 128 ++++++++------- docs/index.rst | 15 ++ docs/interop/conf.py | 15 ++ docs/interop/index.rst | 18 +++ 12 files changed, 449 insertions(+), 81 deletions(-) create mode 100644 docs/conf.py create mode 100644 docs/devel/conf.py create mode 100644 docs/devel/index.rst rename docs/devel/{memory.txt => memory.rst} (85%) create mode 100644 docs/index.rst create mode 100644 docs/interop/conf.py create mode 100644 docs/interop/index.rst -- 2.20.1