From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <SRS0=5giA=6T=gnu.org=eliz@sourceware.org>
Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10])
	by sourceware.org (Postfix) with ESMTPS id 3AF5A385840F
	for <gdb-patches@sourceware.org>; Thu, 23 Feb 2023 15:06:52 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 3AF5A385840F
Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org
Received: from fencepost.gnu.org ([2001:470:142:3::e])
	by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.90_1)
	(envelope-from <eliz@gnu.org>)
	id 1pVDBL-0003UR-Cy; Thu, 23 Feb 2023 10:06:51 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
	s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
	mime-version; bh=dCtRCEFCUk9IlLDmouWCbjLa+AL4yWq2mjY/+i9GfOQ=; b=kE6jfluD2KO7
	QlMuv9l4dEDc7QV39hU/hsrIrgpCr7xpQUnEqmJUAyCvvKbvqFwM7v1g7nSgrdSO0UykHebYTt+pj
	g8g0OLsRiDmcLiIsT4VCOpN2cwYn5SgZB34Skzea/NXQeA5FKqmicSR8v72jLqY3EfTdPSPL6C3Y7
	7gcta1RY1GieS598Ig55UawlZdJCzWwZsvSlOHVuzYprmk/3SL9NIUDbwGVeEEAbSZJ7elpSFRbGT
	nIwswM5gF0vukA1kCTAgJreQozUzeIgZo0h1xwaRxZQYOgU7agbmlozk5YxbuEaICfrPPdBkxQH4r
	3Oxf1VPH2kRw4WjNAy99rg==;
Received: from [87.69.77.57] (helo=home-c4e4a596f7)
	by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.90_1)
	(envelope-from <eliz@gnu.org>)
	id 1pVDBK-0000Hy-8u; Thu, 23 Feb 2023 10:06:50 -0500
Date: Thu, 23 Feb 2023 17:06:47 +0200
Message-Id: <83ttzcpgjc.fsf@gnu.org>
From: Eli Zaretskii <eliz@gnu.org>
To: Luis Machado <luis.machado@arm.com>
Cc: gdb-patches@sourceware.org
In-Reply-To: <e1684a0e-d426-19d6-ddb7-3386811f3261@arm.com> (message from Luis
	Machado on Thu, 23 Feb 2023 13:33:08 +0000)
Subject: Re: [PATCH] [gdb/doc] aarch64: Expand documentation of XML features
References: <20230223095244.1813332-1-luis.machado@arm.com>
 <837cw8r6cf.fsf@gnu.org> <e1684a0e-d426-19d6-ddb7-3386811f3261@arm.com>
X-Spam-Status: No, score=1.8 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_BARRACUDACENTRAL,SPF_HELO_PASS,SPF_PASS,TXREP autolearn=no autolearn_force=no version=3.4.6
X-Spam-Level: *
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org
List-Id: <gdb-patches.sourceware.org>

> Date: Thu, 23 Feb 2023 13:33:08 +0000
> Cc: gdb-patches@sourceware.org
> From: Luis Machado <luis.machado@arm.com>
> 
> On 2/23/23 11:04, Eli Zaretskii wrote:
> > 
> >> +The @samp{cpsr} flags type gets updated based on new architectural
> >> +features.
> > 
> > "flags type gets updated" sounds awkward and confusing.  What did you
> > mean by that? what is updated?
> > 
> 
> Some flags/fields are reserved to be used in future extensions of the architecture.
> 
> For example, suppose bit 26 in 32-bit register is undefined, but then gets defined for a new
> architecture extension. We need to update the XML to reflect that.

Then I suggest something like

  The semantics of the individual flags in @samp{cpsr} can change as
  new architectural features are added.