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 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id BB205C77B73 for ; Wed, 24 May 2023 09:12:31 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q1kXZ-0001yn-H2; Wed, 24 May 2023 05:12:17 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q1kXX-0001sN-53 for qemu-devel@nongnu.org; Wed, 24 May 2023 05:12:15 -0400 Received: from frasgout.his.huawei.com ([185.176.79.56]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q1kXQ-0000mi-Vq for qemu-devel@nongnu.org; Wed, 24 May 2023 05:12:14 -0400 Received: from lhrpeml500005.china.huawei.com (unknown [172.18.147.207]) by frasgout.his.huawei.com (SkyGuard) with ESMTP id 4QR51838d4z6H7vb; Wed, 24 May 2023 17:07:24 +0800 (CST) Received: from localhost (10.122.247.231) by lhrpeml500005.china.huawei.com (7.191.163.240) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Wed, 24 May 2023 10:11:59 +0100 Date: Wed, 24 May 2023 10:11:58 +0100 To: Markus Armbruster CC: , Michael Tsirkin , Fan Ni , , , Ira Weiny , Alison Schofield , Michael Roth , Philippe =?ISO-8859-1?Q?Mathieu-Daud=E9?= , Dave Jiang , , Eric Blake , Mike Maslenkin , =?ISO-8859-1?Q?Marc-Andr=E9?= Lureau , "Thomas Huth" Subject: Re: [PATCH v5 5/7] hw/cxl/events: Add injection of General Media Events Message-ID: <20230524101158.0000579d@huawei.com> In-Reply-To: <87ttw35i6q.fsf@pond.sub.org> References: <20230423165140.16833-1-Jonathan.Cameron@huawei.com> <20230423165140.16833-6-Jonathan.Cameron@huawei.com> <87lehgq1cy.fsf@pond.sub.org> <20230522135737.000079c4@Huawei.com> <87fs7na2o8.fsf@pond.sub.org> <20230523113543.00006a1f@Huawei.com> <87ttw35i6q.fsf@pond.sub.org> Organization: Huawei Technologies R&D (UK) Ltd. X-Mailer: Claws Mail 4.0.0 (GTK+ 3.24.29; x86_64-w64-mingw32) MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Originating-IP: [10.122.247.231] X-ClientProxiedBy: lhrpeml500005.china.huawei.com (7.191.163.240) To lhrpeml500005.china.huawei.com (7.191.163.240) X-CFilter-Loop: Reflected Received-SPF: pass client-ip=185.176.79.56; envelope-from=jonathan.cameron@huawei.com; helo=frasgout.his.huawei.com X-Spam_score_int: -41 X-Spam_score: -4.2 X-Spam_bar: ---- X-Spam_report: (-4.2 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-to: Jonathan Cameron From: Jonathan Cameron via Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org On Tue, 23 May 2023 14:46:37 +0200 Markus Armbruster wrote: > Jonathan Cameron writes: >=20 > >> > =20 > >> >> > +# > >> >> > +# Inject an event record for a General Media Event (CXL r3.0 8.2= .9.2.1.1) =20 > >> >>=20 > >> >> What's "CXL r3.0", and where could a reader find it? =20 > >> > > >> > We have docs in docs/system/devices/cxl.rst that include the consort= ium > >> > website which has download links on the front page. =20 > >>=20 > >> cxl.rst has > >>=20 > >> References > >> ---------- > >>=20 > >> - Consortium website for specifications etc: > >> http://www.computeexpresslink.org > >> - Compute Express link Revision 2 specification, October 2020 > >> - CEDT CFMWS & QTG _DSM ECN May 2021 > >>=20 > >> Should the second reference be updated to 3.0? Exact title seems to be > >> "The Compute Express Link=E2=84=A2 (CXL=E2=84=A2) 3.0 specification". = Not sure we need > >> to bother with the "=E2=84=A2" in a reference. =20 > > > > Yes. On the todo list is to update all the references to latest released > > specification because old ones are unobtainable to non consortium membe= rs > > unless they grabbed a copy in the past. > > > > Annoyingly this will be a repeated requirement as new spec versions are= released > > but the cadence should be fairly low. > > =20 > >> =20 > >> > I'm not sure we= want to > >> > have lots of references to the URL spread throughout QEMU. I can ad= d one > >> > somewhere in cxl.json if you think it is important to have one here = as well. =20 > >>=20 > >> You could add an introduction right under the "# =3D CXL devices" head= ing, > >> and include a full reference to the specification there. Suitably > >> abbreviated references like the ones you use in this patch should then > >> be fine. =20 > > > > I tried doing that - it resulted in the index including an entry with a= ll the text. > > So on the webpage, the contents list to the left includes whatever text= you put > > in that block. > > =20 > > I'm not sure why, or how to fix that. =20 >=20 > Show me what you tried (as a patch or something I can git-pull), and > I'll have a look. >=20 > [...] >=20 Very simple to replicate the issue - see below. Result of this is an extra "Test text" entry in the index to the left of the html docs. In qemu-qmp-ref.html we have
  • CXL devices
    • Test text
    • CxlEv= entLog (Enum)
      • diff --git a/qapi/cxl.json b/qapi/cxl.json index 05c560cfe5..9f7f0485ae 100644 --- a/qapi/cxl.json +++ b/qapi/cxl.json @@ -3,6 +3,8 @@ ## # =3D CXL devices +# +# Test text ## ##