From nobody Thu Dec 26 15:50:41 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass(p=reject dis=none) header.from=citrix.com ARC-Seal: i=1; a=rsa-sha256; t=1732294284; cv=none; d=zohomail.com; s=zohoarc; b=Bn7ONthKhfzpn12xRMjEZ9Ihlkq8GhXedS2cFIVid/VGhlPDzw5uYaHnqkJoyLx+zGu37QH1HlmyRkAtCmCK/0Fy18/PDpA38+LOkcvOterJwQc2UB+qI/NjaNx2uhkUUJo9krW+7FHcxggCdAcunyxRzvQ+7DXcOjdzoC7JhZY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1732294284; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=81E9chfxVe/haFwsGpGAYWMCWngQMTzLIgGBkui4lPg=; b=dy6Qe7ehWa5p7iBSo9nXDDthNfrGYGrlODbYcmOH6ZklU20dxGil6l1beaqy8/K/ZEnJe8R3ZxohNDzrAxXBHQFvOI+jdEh72DpwtATD54FFSFh4Rm+GrTnk3hvunPvwVJ62zUoMmTb2vgsnCoxNypXtKKILuZHMXNZreVkoGE0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass header.from= (p=reject dis=none) Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1732294284398373.19801769212063; Fri, 22 Nov 2024 08:51:24 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.841979.1257442 (Exim 4.92) (envelope-from ) id 1tEWsC-0004Ar-Aa; Fri, 22 Nov 2024 16:51:12 +0000 Received: by outflank-mailman (output) from mailman id 841979.1257442; Fri, 22 Nov 2024 16:51:12 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tEWsC-0004Ak-7w; Fri, 22 Nov 2024 16:51:12 +0000 Received: by outflank-mailman (input) for mailman id 841979; Fri, 22 Nov 2024 16:51:10 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tEWsA-0004AY-Pb for xen-devel@lists.xenproject.org; Fri, 22 Nov 2024 16:51:10 +0000 Received: from mail-ej1-x632.google.com (mail-ej1-x632.google.com [2a00:1450:4864:20::632]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id f76e8385-a8f1-11ef-a0cc-8be0dac302b0; Fri, 22 Nov 2024 17:51:06 +0100 (CET) Received: by mail-ej1-x632.google.com with SMTP id a640c23a62f3a-a9ed49ec0f1so381875166b.1 for ; Fri, 22 Nov 2024 08:51:06 -0800 (PST) Received: from andrewcoop.eng.citrite.net ([185.25.67.249]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-aa50b28f8a1sm118743866b.41.2024.11.22.08.51.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 22 Nov 2024 08:51:04 -0800 (PST) X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: f76e8385-a8f1-11ef-a0cc-8be0dac302b0 X-Custom-Connection: eyJyZW1vdGVpcCI6IjJhMDA6MTQ1MDo0ODY0OjIwOjo2MzIiLCJoZWxvIjoibWFpbC1lajEteDYzMi5nb29nbGUuY29tIn0= X-Custom-Transaction: eyJpZCI6ImY3NmU4Mzg1LWE4ZjEtMTFlZi1hMGNjLThiZTBkYWMzMDJiMCIsInRzIjoxNzMyMjk0MjY2LjUyMTQ1NSwic2VuZGVyIjoiYW5kcmV3LmNvb3BlckBjbG91ZC5jb20iLCJyZWNpcGllbnQiOiJ4ZW4tZGV2ZWxAbGlzdHMueGVucHJvamVjdC5vcmcifQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=citrix.com; s=google; t=1732294265; x=1732899065; darn=lists.xenproject.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=81E9chfxVe/haFwsGpGAYWMCWngQMTzLIgGBkui4lPg=; b=kQ8VcNAt6ew0at402QRPYhjeto0145A2UCIQiz/mxrh05Ch1QkRJJgOLy1zhrwyObi 5GfJbwTtWd6yS3Ojh9EFeu3HrZExOg7Rm2H3FvCTz3D8RR75nKleW9DU0i0ieD+XjpQH lX9n33IbbymC2iLyP6DZDnckV6sEuRQV+hGSE= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1732294265; x=1732899065; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=81E9chfxVe/haFwsGpGAYWMCWngQMTzLIgGBkui4lPg=; b=lR0OsWBIwYMARZ2cbMxgin4yK7Vhl2159Ye6ZhH2UV07G/6om8Vzv6vxF+tTlWTFl+ cfVxUBoWDq8eQA4bOptduxrcPwXGVvvORo4hRJmNISSR7EvwndkwKuIIgugxglT2dFgf 85ucwxfRAgtuhWsz8KG1Iqn1mQSUgtDSKibv1aCLhwSxCsvsfwyqfLK1P/b2VCjjqelA uQH49Jt2wuKi4xCL0ccE+gr4L5mjMWyznjeML1vW2uoyRhOm01jCEwn+1BYg3Y3R56qE m24e083eJcUQJdoXFAtwG42fIvsGXMT4z+MBoGkL6kt64yySF/4Ef/ji7uE7JJSDSKQn Jf2w== X-Gm-Message-State: AOJu0Yyr+iwZ5Ds3pVoUPJb7F1+DeTdJF+KuD70Mn81iNUacEAOXj4eC 0KcEIBiHO1QcHMKeoXnG5Y9cvkj89dMSV89FzbZUD7U9UphM413IfKpIqlyfjf15Yr6cJiVMzi8 C X-Gm-Gg: ASbGncs4ZDD9GOZQeryBIoRzIEPZRjQt1NuOjeTXJNOin3D7/DMsRplKtePnrzOOtQw hP93dgX06DTSL54XBzT1QZuNU9xS/IOLlDFSWWel1mHzgBO8RxCqwUZxBza4slr4xSa6fgJ1ERk 1sqG7Lh6Ztj7VoXuDIeOEi79qT6G1uO8Z8DVOWU6ot3oFaK4EYgntlghOVokQXbINf7FGZmoHrB ggOjsHQyBtGCsO7AOt9cYKQ3UGstza0+UVwRVS8l6/ut+vl05FCrpvu5CBoXkrW9hSHt6Lhz9dl X-Google-Smtp-Source: AGHT+IEyKZi7aOMN1UcA6IIzOe+i6MNwwZgL1QrkGh7fEy+e6RoCOwlRo4gnUlUSXBo2D8ImLkRMfA== X-Received: by 2002:a17:906:314c:b0:a9a:2a56:91e with SMTP id a640c23a62f3a-aa509975d39mr288237666b.6.1732294265581; Fri, 22 Nov 2024 08:51:05 -0800 (PST) From: Andrew Cooper To: Xen-devel Cc: Andrew Cooper , Jan Beulich , Stefano Stabellini , Julien Grall Subject: [PATCH] docs/sphinx: Refresh config for newer Sphinx Date: Fri, 22 Nov 2024 16:51:02 +0000 Message-Id: <20241122165102.3240758-1-andrew.cooper3@citrix.com> X-Mailer: git-send-email 2.39.5 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @citrix.com) X-ZM-MESSAGEID: 1732294286912116600 Content-Type: text/plain; charset="utf-8" Sphinx 5.0 and newer objects to language =3D None. Switch to 'en'. Also update the copyright year. Use %Y to avoid this problem in the future, and provide compatibility for versions of Sphinx prior to 8.1 which don't support the syntax. Signed-off-by: Andrew Cooper Acked-by: Stefano Stabellini --- CC: Jan Beulich CC: Stefano Stabellini CC: Julien Grall This is in prepartion to get a Gitlab CI docs job, and to activate Sphinx's -Werror equivelent. --- docs/conf.py | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 50e41501db8f..5d2e97944900 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -3,9 +3,8 @@ # # Configuration file for the Sphinx documentation builder. # -# This file does only contain a selection of the most common options. For a -# full list see the documentation: -# http://www.sphinx-doc.org/en/master/config +# For the full list of built-in configuration values, see the documentatio= n: +# https://www.sphinx-doc.org/en/master/usage/configuration.html =20 # -- Path setup ----------------------------------------------------------= ---- =20 @@ -19,11 +18,18 @@ =20 =20 # -- Project information -------------------------------------------------= ---- +# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-in= formation + +import sphinx =20 project =3D u'Xen' -copyright =3D u'2019, The Xen development community' +copyright =3D u'2019-%Y, The Xen development community' author =3D u'The Xen development community' =20 +if sphinx.version_info < (8, 1): + from datetime import datetime + copyright =3D datetime.today().strftime(copyright) + # Pull the Xen version straight out of the Makefile try: xen_ver =3D xen_subver =3D xen_extra =3D None @@ -45,6 +51,7 @@ finally: version =3D release =3D u"unknown version" =20 # -- General configuration -----------------------------------------------= ---- +# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-co= nfiguration =20 # If your documentation needs a minimal Sphinx version, state it here. # @@ -69,10 +76,7 @@ master_doc =3D 'index' =20 # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. -# -# This is also used if you do content translation via gettext catalogs. -# Usually you set "language" from the command line for these cases. -language =3D None +language =3D 'en' =20 # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. @@ -86,6 +90,7 @@ primary_domain =3D 'c' highlight_language =3D 'none' =20 # -- Options for HTML output ---------------------------------------------= ---- +# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-fo= r-html-output =20 # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. base-commit: c0bf8816c9e2a4701c925d8b23abfda5990a0087 prerequisite-patch-id: b4ef4fc3ee5669c078aa0b9c7501ac7ef673966c --=20 2.39.5