From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 58382C4338F for ; Mon, 23 Aug 2021 10:48:52 +0000 (UTC) Received: from lists.ozlabs.org (lists.ozlabs.org [112.213.38.117]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 9203C6136F for ; Mon, 23 Aug 2021 10:48:51 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 9203C6136F Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=canb.auug.org.au Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=lists.ozlabs.org Received: from boromir.ozlabs.org (localhost [IPv6:::1]) by lists.ozlabs.org (Postfix) with ESMTP id 4GtTW54LBXz2xsC for ; Mon, 23 Aug 2021 20:48:49 +1000 (AEST) Authentication-Results: lists.ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; secure) header.d=canb.auug.org.au header.i=@canb.auug.org.au header.a=rsa-sha256 header.s=201702 header.b=FFy1BuB3; dkim-atps=neutral Authentication-Results: lists.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=canb.auug.org.au (client-ip=203.11.71.1; helo=ozlabs.org; envelope-from=sfr@canb.auug.org.au; receiver=) Authentication-Results: lists.ozlabs.org; dkim=pass (2048-bit key; secure) header.d=canb.auug.org.au header.i=@canb.auug.org.au header.a=rsa-sha256 header.s=201702 header.b=FFy1BuB3; dkim-atps=neutral Received: from ozlabs.org (ozlabs.org [203.11.71.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 4GtTVK0ncZz2xrT for ; Mon, 23 Aug 2021 20:48:07 +1000 (AEST) Received: from authenticated.ozlabs.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mail.ozlabs.org (Postfix) with ESMTPSA id 4GtTVD3CQ5z9sWc; Mon, 23 Aug 2021 20:48:04 +1000 (AEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=canb.auug.org.au; s=201702; t=1629715685; bh=ytEvyC+DEnLTTfZkIg3wkrRmLBORVvoxKCJVWjIoJH8=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=FFy1BuB3h/44cQ8yyheLTod8gxRDOgY3fD4DlBfZI6fru5t0lc2n9QtLOeq+d3DDa xD5etjFiIlQziNsGx+PMbqdI8Q67eaCPdlfMqWpZJi9E10vTHFIMmpWSZPnFHrlRrW ul6z6eDmmubA8/1FpvWbVz6un9R6SZAtOWp0IeatzKQ+N1XM+6EQv7TmIWD/LhoKU4 JoK2ghRkWZVki6NA5zAGnGdZlws9Qi2W4gedFCP3op7Z3h3Jsvk1HPfL+WFZWnD3Ns tExLyFsN70uPBfbHQUZeYzr+vx25SqJWKnUvi9CihCiXy6LOFgX6petrVzB8qQ/sYG WsjneOXuzY1XQ== Date: Mon, 23 Aug 2021 20:48:03 +1000 From: Stephen Rothwell To: Michael Ellerman , PowerPC Subject: Re: linux-next: build warning after merge of the powerpc tree Message-ID: <20210823204803.7cb76778@canb.auug.org.au> In-Reply-To: <20210823195540.4d7363ed@canb.auug.org.au> References: <20210823195540.4d7363ed@canb.auug.org.au> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="Sig_/sxdg6gsIpF4HdmJ_XxRwn8Z"; protocol="application/pgp-signature"; micalg=pgp-sha256 X-BeenThere: linuxppc-dev@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: "Aneesh Kumar K.V" , Linux Next Mailing List , Daniel Henrique Barboza , Linux Kernel Mailing List , Jonathan Corbet Errors-To: linuxppc-dev-bounces+linuxppc-dev=archiver.kernel.org@lists.ozlabs.org Sender: "Linuxppc-dev" --Sig_/sxdg6gsIpF4HdmJ_XxRwn8Z Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Hi all, [cc'ing Jon in case he can fix the sphix hang - or knows anything about it] On Mon, 23 Aug 2021 19:55:40 +1000 Stephen Rothwell = wrote: > > After merging the powerpc tree, today's linux-next build (htmldocs) > produced this warning: >=20 I missed a line: Sphinx parallel build error: > docutils.utils.SystemMessage: Documentation/powerpc/associativity.rst:1: = (SEVERE/4) Title overline & underline mismatch. >=20 > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D > NUMA resource associativity > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D >=20 > Introduced by commit >=20 > 1c6b5a7e7405 ("powerpc/pseries: Add support for FORM2 associativity") >=20 > There are other obvious problems with this document (but sphinx seems > to have hung before it reported them). >=20 > Like >=20 > Form 0 > ----- >=20 > and >=20 > Form 1 > ----- >=20 > and >=20 > Form 2 > ------- I also get the following warning: Documentation/powerpc/associativity.rst: WARNING: document isn't included i= n any toctree And applying the following patch is enough to allow sphinx to finish (rather than livelocking): diff --git a/Documentation/powerpc/associativity.rst b/Documentation/powerp= c/associativity.rst index 07e7dd3d6c87..b77c6ccbd6cb 100644 --- a/Documentation/powerpc/associativity.rst +++ b/Documentation/powerpc/associativity.rst @@ -1,6 +1,6 @@ -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D NUMA resource associativity -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D =20 Associativity represents the groupings of the various platform resources i= nto domains of substantially similar mean performance relative to resources ou= tside @@ -20,11 +20,11 @@ A value of 1 indicates the usage of Form 1 associativit= y. For Form 2 associativi bit 2 of byte 5 in the "ibm,architecture-vec-5" property is used. =20 Form 0 ------ +------ Form 0 associativity supports only two NUMA distances (LOCAL and REMOTE). =20 Form 1 ------ +------ With Form 1 a combination of ibm,associativity-reference-points, and ibm,a= ssociativity device tree properties are used to determine the NUMA distance between res= ource groups/domains. =20 @@ -45,7 +45,7 @@ level of the resource group, the kernel doubles the NUMA = distance between the comparing domains. =20 Form 2 -------- +------ Form 2 associativity format adds separate device tree properties represent= ing NUMA node distance thereby making the node distance computation flexible. Form 2 also allows = flexible primary domain numbering. With numa distance computation now detached from the ind= ex value in --=20 Cheers, Stephen Rothwell --Sig_/sxdg6gsIpF4HdmJ_XxRwn8Z Content-Type: application/pgp-signature Content-Description: OpenPGP digital signature -----BEGIN PGP SIGNATURE----- iQEzBAEBCAAdFiEENIC96giZ81tWdLgKAVBC80lX0GwFAmEjfOMACgkQAVBC80lX 0GyLKggAhCMrgdwGxkXle5T2qBzbCLLt9t4orSVuLnnyOdL/bZOW3T4uZoeNrwE3 ZgvcuzFGHpNjiT84wlMR1Ui6tD/cSF95PEyno26ZoifhPQELvZxBgiYQtCirrgIJ Co8qEQPsScICE8fvNNhwbliv/xYTei+Hfj2tED/FugRbaHHqoOOjUVUfO/PI0roZ kRD8H5x35d+oYVUwhqmzmYWMYtcdnyXcu3vsx587Nr3O9yk0n+PLwU6OaAgSPtt7 PMo+QNZsm+E/Uyvvjkc1wPU5x8UGlU0nOGsLFAjycWrhBeTztpZlunjAHKyfqPQX GLRByUmgTZmQw9Gs0SfxO+QhZpkYCQ== =4JXF -----END PGP SIGNATURE----- --Sig_/sxdg6gsIpF4HdmJ_XxRwn8Z--