From nobody Sat Feb 7 09:12:11 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1604322752; cv=none; d=zohomail.com; s=zohoarc; b=Ya9O2pNJDGS6aqS5/ZJg2thP9ydlanPapFPZuyLmbh1OHUNUAoAu7tBab0vG8Erlj6ll00Km9Q+bMEOFFFE6CpQHNitikfqTuS0mqpNfBgZjFMH3+SAlIBaYQICdVjkTYNMim0c9tqlMzQhhM8XwnZEwXF3s7ABqaSzDA6xQSjw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604322752; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=Xy2HRjSSA05hef6gIxAcCqdg0PtsNzO75QaSgj9hCZQ=; b=YwunO1jt0MS9zqtNArXpO7m1j4WNzPJMqdRPjEOuLoQ2H3LDBOOWJOs78AuK/6e6+yfmZoUVB4hqubCF8yqDYpK1Ex2p6K7dIY9X24TEGiTigsMVALXBR6isAID58USq5MQLuXXlDNtImD8E5l5lm5zcaJcXoK1mLgQh9Z2n9X8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1604322752866828.6347680222559; Mon, 2 Nov 2020 05:12:32 -0800 (PST) Received: from localhost ([::1]:37836 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZZdP-00085J-I9 for importer@patchew.org; Mon, 02 Nov 2020 08:12:31 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:38922) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZZai-0004Mi-Ax for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:44 -0500 Received: from us-smtp-delivery-124.mimecast.com ([63.128.21.124]:51581) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1kZZag-0003Ln-GF for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:44 -0500 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-218-oy2SrOtlODOIpzKwZKyguA-1; Mon, 02 Nov 2020 08:09:37 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 4AF451074655; Mon, 2 Nov 2020 13:09:36 +0000 (UTC) Received: from fedora.redhat.com (ovpn-114-136.ams2.redhat.com [10.36.114.136]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1B3A9109F1B9; Mon, 2 Nov 2020 13:09:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604322581; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=Xy2HRjSSA05hef6gIxAcCqdg0PtsNzO75QaSgj9hCZQ=; b=haDpBEcnPL3zf/I/GDTH0S0ZSAI5haLDctldTkxK7ugcPCspAHDzHXXWWhjZ9PgqYIrxa1 oYAtfJtunUs6Cc+nQ6l3Cp4nVGd2+Yz9xDIRaNGpUw3ioSXaI5lUH66abAR75MyV7e22Pf m04MwhVdGL5UeOOBOEmmJREieFTYKHo= X-MC-Unique: oy2SrOtlODOIpzKwZKyguA-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: qemu-devel@nongnu.org Subject: [PATCH 1/4] gitlab: publish the docs built during CI Date: Mon, 2 Nov 2020 13:09:23 +0000 Message-Id: <20201102130926.161183-2-berrange@redhat.com> In-Reply-To: <20201102130926.161183-1-berrange@redhat.com> References: <20201102130926.161183-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=berrange@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=63.128.21.124; envelope-from=berrange@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/02 03:02:24 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , Thomas Huth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Wainer dos Santos Moschetta , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Most of the build jobs will create the sphinx documentation. If we expose this as an artifact of a "pages" job in a "public" directory, it will get published using GitLab Pages. This means a user can push a branch with docs changes to GitLab and view the results at https://yourusername.gitlab.io/qemu/ Signed-off-by: Daniel P. Berrang=C3=A9 Reviewed-by: Philippe Mathieu-Daud=C3=A9 Tested-by: Philippe Mathieu-Daud=C3=A9 --- .gitlab-ci.yml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 3b15ae5c30..a41725d6f7 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -423,3 +423,17 @@ check-dco: - $CI_PROJECT_NAMESPACE =3D=3D 'qemu-project' && $CI_COMMIT_BRANCH = =3D=3D 'master' variables: GIT_DEPTH: 1000 + +pages: + image: $CI_REGISTRY_IMAGE/qemu/ubuntu2004:latest + stage: test + needs: + - job: build-system-ubuntu + artifacts: true + script: + - mkdir public + - mv build/docs/index.html public/ + - for i in devel interop specs system tools user ; do mv build/docs/$i= public/ ; done + artifacts: + paths: + - public --=20 2.28.0 From nobody Sat Feb 7 09:12:11 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1604322675; cv=none; d=zohomail.com; s=zohoarc; b=d7QSss9gdcY1THY2KB2RNpjeyzxwHMltZ5dIsN1JD+8yuBoC8fxFSvF34knnfaYbWDv2uMSDej0AVWTlt9cYYg3fcifgx827CvSH47aQWiRvA90H2HAqRiYG6jpd/EzNva5ohwKNSFL3/7prh55GPCN+JjuJmNWBqVP3DS9OCiE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604322675; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=B/LM4wfIa4cVIdLEi2TuLjN3k4rymWp18Mv8P2Vo+Ao=; b=YqN/gHYaVlHd2GBZ2PgSm1Nv2Op4vNSfR0zdKLKkvtSJ0vSRwtBwFaylLPdga+pGu7TroBMwdb5zej0FVdk4GIibl1XAJOmXUjbJYBOgszAhYUaIY5zGucmuGHKuLtWi1oRDh8t5/EWbs/agOPojYzRXwHP49LZbCQyS4aj1jWs= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1604322675289886.8909339761763; Mon, 2 Nov 2020 05:11:15 -0800 (PST) Received: from localhost ([::1]:59922 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZZc9-0005dc-T1 for importer@patchew.org; Mon, 02 Nov 2020 08:11:13 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:38912) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZZah-0004M8-SB for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:43 -0500 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:59869) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1kZZag-0003Ls-7Q for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:43 -0500 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-531-9abRmovSO0mfh-oGsS17pw-1; Mon, 02 Nov 2020 08:09:39 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id B2BBE809DD3; Mon, 2 Nov 2020 13:09:38 +0000 (UTC) Received: from fedora.redhat.com (ovpn-114-136.ams2.redhat.com [10.36.114.136]) by smtp.corp.redhat.com (Postfix) with ESMTP id 9075D1002C21; Mon, 2 Nov 2020 13:09:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604322581; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=B/LM4wfIa4cVIdLEi2TuLjN3k4rymWp18Mv8P2Vo+Ao=; b=b/nbZo5VsWBLEqcGOaTgwV58uAZJXicXsEcqBG/J7XQ/+c/7P3cmoEWgcETT7ttpCESgre HsLCnkB0AOR8USn+hrPeOIz8uHmuorPl8V++rSnTEJwhCI9lKyYHpyOhh22nNSBoXk/RSS qE66OBhiptz4avBI12mznAlJm/tDQoI= X-MC-Unique: 9abRmovSO0mfh-oGsS17pw-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: qemu-devel@nongnu.org Subject: [PATCH 2/4] gitlab: force enable docs build in Fedora, Ubuntu, Debian Date: Mon, 2 Nov 2020 13:09:24 +0000 Message-Id: <20201102130926.161183-3-berrange@redhat.com> In-Reply-To: <20201102130926.161183-1-berrange@redhat.com> References: <20201102130926.161183-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=berrange@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=216.205.24.124; envelope-from=berrange@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/02 01:33:03 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , Thomas Huth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Wainer dos Santos Moschetta , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Meson runs a test to see if Sphinx works, and automatically disables it on error. This can lead to the CI jobs skipping docs build without maintainers noticing the problem. Use --enable-docs to force a fatal error if Sphinx doesn't work on the jobs where we expect it to be OK. Signed-off-by: Daniel P. Berrang=C3=A9 Reviewed-by: Philippe Mathieu-Daud=C3=A9 Tested-by: Philippe Mathieu-Daud=C3=A9 --- .gitlab-ci.yml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index a41725d6f7..f17bff652d 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -80,6 +80,7 @@ build-system-ubuntu: TARGETS: aarch64-softmmu alpha-softmmu cris-softmmu hppa-softmmu moxie-softmmu microblazeel-softmmu mips64el-softmmu MAKE_CHECK_ARGS: check-build + CONFIGURE_ARGS: --enable-docs artifacts: expire_in: 2 days paths: @@ -111,6 +112,7 @@ build-system-debian: TARGETS: arm-softmmu avr-softmmu i386-softmmu mipsel-softmmu riscv64-softmmu sh4eb-softmmu sparc-softmmu xtensaeb-softmmu MAKE_CHECK_ARGS: check-build + CONFIGURE_ARGS: --enable-docs artifacts: expire_in: 2 days paths: @@ -139,7 +141,7 @@ build-system-fedora: <<: *native_build_job_definition variables: IMAGE: fedora - CONFIGURE_ARGS: --disable-gcrypt --enable-nettle + CONFIGURE_ARGS: --disable-gcrypt --enable-nettle --enable-docs TARGETS: tricore-softmmu microblaze-softmmu mips-softmmu xtensa-softmmu m68k-softmmu riscv32-softmmu ppc-softmmu sparc64-soft= mmu MAKE_CHECK_ARGS: check-build --=20 2.28.0 From nobody Sat Feb 7 09:12:11 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1604322836; cv=none; d=zohomail.com; s=zohoarc; b=el4jhEO9QufkYwyTG91+svitFG7O6XSbVgEauMbAhpBEDuFfxw/M++/9RVHwFDgyHcCznp5ckSMxfGozFOj5vZROcSwyadpIqJy9neNWB2wXBXoTyXdzjnJIMeZxrjmfQb5WB/RSASQVHvgs2TYGQ9i+rZoVFuDiTjv58cakTIg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604322836; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=xkzOcfULddzdjgTJYmiy3AM503DDuZdPb/VoF702x14=; b=HlfY7NVqpIgXW476Dk5wXPp6Pe9bXFwMyzX7VRmZlhMwjG31FcV72wEclz/g8ij/Pv7iJv4akcInqy5YPusk+7sp2j8YTE+YM9HewD9fNd3XlBPSDJjxulAIsTqPWkRWQieDsJV2zT0TSP8NBguT6W4PYLGQN40tNW0w8lVZC+o= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1604322836365268.71455192116275; Mon, 2 Nov 2020 05:13:56 -0800 (PST) Received: from localhost ([::1]:40928 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZZel-0000wK-AP for importer@patchew.org; Mon, 02 Nov 2020 08:13:55 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:38950) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZZak-0004PO-Hj for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:46 -0500 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:35764) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1kZZai-0003NH-OV for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:46 -0500 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-593-XYcGYT7-PeK3up1ItBigwA-1; Mon, 02 Nov 2020 08:09:42 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 47F9B1009E25; Mon, 2 Nov 2020 13:09:41 +0000 (UTC) Received: from fedora.redhat.com (ovpn-114-136.ams2.redhat.com [10.36.114.136]) by smtp.corp.redhat.com (Postfix) with ESMTP id 71D141002C21; Mon, 2 Nov 2020 13:09:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604322584; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=xkzOcfULddzdjgTJYmiy3AM503DDuZdPb/VoF702x14=; b=AYmYta8jbSzB8PqsIv2vo21szh+sCxGY3WnODmeds+XjykHhsBUCY8DCzEciHQST0c0M4/ 5ATQat1Pwd7sxJ3mFGSJFUP2E93m+mrmkx+yrGcN6YR0DefP2JfANIRl4O8nauitnP7wbj Q0ZUOFehqd1n3AQlbmRvK0+hk01Mhk0= X-MC-Unique: XYcGYT7-PeK3up1ItBigwA-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: qemu-devel@nongnu.org Subject: [PATCH 3/4] docs: show stdout/stderr when meson fails build test Date: Mon, 2 Nov 2020 13:09:25 +0000 Message-Id: <20201102130926.161183-4-berrange@redhat.com> In-Reply-To: <20201102130926.161183-1-berrange@redhat.com> References: <20201102130926.161183-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=berrange@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=216.205.24.124; envelope-from=berrange@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/02 01:33:03 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , Thomas Huth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Wainer dos Santos Moschetta , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) It is hard to diagnose why Sphinx fails in a CI environment, as we discard the stdout/err and just print a generic error message. Signed-off-by: Daniel P. Berrang=C3=A9 --- docs/meson.build | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/meson.build b/docs/meson.build index 8c222f96bb..278098dd4f 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -20,14 +20,15 @@ if sphinx_build.found() # version requirement). This will fail if sphinx-build is too old. run_command('mkdir', ['-p', tmpdir / 'sphinx']) run_command('touch', [tmpdir / 'sphinx/index.rst']) - sphinx_build_test_out =3D run_command(SPHINX_ARGS + [ + sphinx_cmd =3D run_command(SPHINX_ARGS + [ '-c', meson.current_source_dir(), '-b', 'html', tmpdir / 'sphinx', tmpdir / 'sphinx/out']) - build_docs =3D (sphinx_build_test_out.returncode() =3D=3D 0) + build_docs =3D (sphinx_cmd.returncode() =3D=3D 0) =20 if not build_docs - warning('@0@ exists but it is either too old or uses too old a Python = version'.format(get_option('sphinx_build'))) + warning('@0@ exists but it is either too old or uses too old a Python = version\nstdout:@1@\nstderr:@2@'.format( + get_option('sphinx_build'), sphinx_cmd.stdout().strip(), sphinx_cmd.= stderr().strip())) if get_option('docs').enabled() error('Install a Python 3 version of python-sphinx') endif --=20 2.28.0 From nobody Sat Feb 7 09:12:11 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1604322748; cv=none; d=zohomail.com; s=zohoarc; b=g9Vq7XgvIALBg0baF/GFGJnwIN1rBt+dwttCSTP1mbRQ26qPMCn6Rk2sFluvaz9USzXC0PzKxiB5301rsbD1RYCKDQXGFbKGxWQ9IfQq5O5/2PDt08HJ0BCN2Zl8BmdQcX3L7hgswu4Qx9h1AfDV2AcfWJjU1t8ksDpg4VRW+TY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604322748; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=c3hvqOjW7rYuo8tMqhIffzq8DNC5WH0yrkHpYl34dHk=; b=n8kDE5fS8zaj33sSUqMpJNnV3Z2f0DNODLu++RHaUZk20n4laMk87LLZL6BYNbTMffXomHEgIgKBm8Dgu/A0eMlkuo3lb08Ca5ostbpgs29ZdAIh9hPINdwwdnTmoTW0tfNls0Cy2bBTDTd2Et1g4KTY7k06Y4qzbzXaZec/v2U= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1604322748261270.58433127542514; Mon, 2 Nov 2020 05:12:28 -0800 (PST) Received: from localhost ([::1]:37512 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZZdK-0007xR-UF for importer@patchew.org; Mon, 02 Nov 2020 08:12:26 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:38990) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZZar-0004Rp-50 for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:54 -0500 Received: from us-smtp-delivery-124.mimecast.com ([63.128.21.124]:25523) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.90_1) (envelope-from ) id 1kZZam-0003Nr-0v for qemu-devel@nongnu.org; Mon, 02 Nov 2020 08:09:51 -0500 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-590-8Mc2rZUtMNCknw2gfm3o_A-1; Mon, 02 Nov 2020 08:09:44 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id BB3FB1868407; Mon, 2 Nov 2020 13:09:43 +0000 (UTC) Received: from fedora.redhat.com (ovpn-114-136.ams2.redhat.com [10.36.114.136]) by smtp.corp.redhat.com (Postfix) with ESMTP id B2A3D1002C27; Mon, 2 Nov 2020 13:09:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604322586; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=c3hvqOjW7rYuo8tMqhIffzq8DNC5WH0yrkHpYl34dHk=; b=i9Z6ZpVJIGNZMuxntnmP9g+0t1EmdXi9OcoUR5A9S9+r2CPqqIbD/XC6EOOfPxgYkVq5vR vP2+BdLvq5rqci+uKlqCocR6Qq7t4XgTJTqEP3I7MJs64OOA/yR6ZpO+tqiE1UplEiy2Cw DOKqrcM60s03A3Kpim00BUpl618+4Uc= X-MC-Unique: 8Mc2rZUtMNCknw2gfm3o_A-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: qemu-devel@nongnu.org Subject: [PATCH 4/4] docs: add "page source" link to sphinx documentation Date: Mon, 2 Nov 2020 13:09:26 +0000 Message-Id: <20201102130926.161183-5-berrange@redhat.com> In-Reply-To: <20201102130926.161183-1-berrange@redhat.com> References: <20201102130926.161183-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=berrange@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=63.128.21.124; envelope-from=berrange@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/02 03:02:24 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , Thomas Huth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Wainer dos Santos Moschetta , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Add a link to the top of the sidebar in every docs page that takes the user back to the source code in gitlab. Signed-off-by: Daniel P. Berrang=C3=A9 --- docs/_templates/editpage.html | 5 +++++ docs/conf.py | 1 + docs/devel/_templates/editpage.html | 5 +++++ docs/interop/_templates/editpage.html | 5 +++++ docs/specs/_templates/editpage.html | 5 +++++ docs/system/_templates/editpage.html | 5 +++++ docs/tools/_templates/editpage.html | 5 +++++ docs/user/_templates/editpage.html | 5 +++++ 8 files changed, 36 insertions(+) create mode 100644 docs/_templates/editpage.html create mode 100644 docs/devel/_templates/editpage.html create mode 100644 docs/interop/_templates/editpage.html create mode 100644 docs/specs/_templates/editpage.html create mode 100644 docs/system/_templates/editpage.html create mode 100644 docs/tools/_templates/editpage.html create mode 100644 docs/user/_templates/editpage.html diff --git a/docs/_templates/editpage.html b/docs/_templates/editpage.html new file mode 100644 index 0000000000..4319b0f5ac --- /dev/null +++ b/docs/_templates/editpage.html @@ -0,0 +1,5 @@ +
+ +
diff --git a/docs/conf.py b/docs/conf.py index e584f68393..d40d8ff37b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -177,6 +177,7 @@ html_theme_options =3D { html_sidebars =3D { '**': [ 'about.html', + 'editpage.html', 'navigation.html', 'searchbox.html', ] diff --git a/docs/devel/_templates/editpage.html b/docs/devel/_templates/ed= itpage.html new file mode 100644 index 0000000000..a86d22bca8 --- /dev/null +++ b/docs/devel/_templates/editpage.html @@ -0,0 +1,5 @@ +
+ +
diff --git a/docs/interop/_templates/editpage.html b/docs/interop/_template= s/editpage.html new file mode 100644 index 0000000000..215e562681 --- /dev/null +++ b/docs/interop/_templates/editpage.html @@ -0,0 +1,5 @@ +
+ +
diff --git a/docs/specs/_templates/editpage.html b/docs/specs/_templates/ed= itpage.html new file mode 100644 index 0000000000..aaa468aa98 --- /dev/null +++ b/docs/specs/_templates/editpage.html @@ -0,0 +1,5 @@ +
+ +
diff --git a/docs/system/_templates/editpage.html b/docs/system/_templates/= editpage.html new file mode 100644 index 0000000000..6586b2e257 --- /dev/null +++ b/docs/system/_templates/editpage.html @@ -0,0 +1,5 @@ +
+ +
diff --git a/docs/tools/_templates/editpage.html b/docs/tools/_templates/ed= itpage.html new file mode 100644 index 0000000000..2a9c8fc92b --- /dev/null +++ b/docs/tools/_templates/editpage.html @@ -0,0 +1,5 @@ +
+ +
diff --git a/docs/user/_templates/editpage.html b/docs/user/_templates/edit= page.html new file mode 100644 index 0000000000..1f5ee01e60 --- /dev/null +++ b/docs/user/_templates/editpage.html @@ -0,0 +1,5 @@ +
+ +
--=20 2.28.0