From: Sandra Loosemore <sandra@codesourcery.com>
Date: Mon, 12 Nov 2018 19:08:37 +0000 (-0500)
Subject: re PR middle-end/21110 (incorrect documentat for high and lo_sum RTL operators)
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=52ed66ec25474619919be18f3cf8a15cb7f6ea45;p=gcc.git

re PR middle-end/21110 (incorrect documentat for high and lo_sum RTL operators)

2018-11-12  Sandra Loosemore  <sandra@codesourcery.com>

	PR middle-end/21110

	gcc/
	* doc/rtl.texi (Constants): Clarify that mode of "high" doesn't
	have to be Pmode.
	(Arithmetic): Likewise for "lo_sum".

From-SVN: r266035
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 6b4a14b946b..41b05fb3db4 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,10 @@
+2018-11-12  Sandra Loosemore  <sandra@codesourcery.com>
+
+	PR middle-end/21110
+	* doc/rtl.texi (Constants): Clarify that mode of "high" doesn't
+	have to be Pmode.
+	(Arithmetic): Likewise for "lo_sum".
+
 2018-11-12  Renlin Li  <renlin.li@arm.com>
 
 	PR target/87815
diff --git a/gcc/doc/rtl.texi b/gcc/doc/rtl.texi
index ac8062d3e93..9c00a7f31d7 100644
--- a/gcc/doc/rtl.texi
+++ b/gcc/doc/rtl.texi
@@ -1883,14 +1883,14 @@ of relocation operator.  @var{m} should be a valid address mode.
 
 @findex high
 @item (high:@var{m} @var{exp})
-Represents the high-order bits of @var{exp}, usually a
-@code{symbol_ref}.  The number of bits is machine-dependent and is
+Represents the high-order bits of @var{exp}.  
+The number of bits is machine-dependent and is
 normally the number of bits specified in an instruction that initializes
 the high order bits of a register.  It is used with @code{lo_sum} to
 represent the typical two-instruction sequence used in RISC machines to
-reference a global memory location.
-
-@var{m} should be @code{Pmode}.
+reference large immediate values and/or link-time constants such
+as global memory addresses.  In the latter case, @var{m} is @code{Pmode}
+and @var{exp} is usually a constant expression involving @code{symbol_ref}.
 @end table
 
 @findex CONST0_RTX
@@ -2429,15 +2429,15 @@ saturates at the maximum signed value representable in @var{m};
 
 This expression represents the sum of @var{x} and the low-order bits
 of @var{y}.  It is used with @code{high} (@pxref{Constants}) to
-represent the typical two-instruction sequence used in RISC machines
-to reference a global memory location.
+represent the typical two-instruction sequence used in RISC machines to
+reference large immediate values and/or link-time constants such
+as global memory addresses.  In the latter case, @var{m} is @code{Pmode}
+and @var{y} is usually a constant expression involving @code{symbol_ref}.
 
 The number of low order bits is machine-dependent but is
-normally the number of bits in a @code{Pmode} item minus the number of
+normally the number of bits in mode @var{m} minus the number of
 bits set by @code{high}.
 
-@var{m} should be @code{Pmode}.
-
 @findex minus
 @findex ss_minus
 @findex us_minus