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 6b4a14b946b779f191bfdffcd0cc16eee6487730..41b05fb3db4a8f2b476d47c83f924fd6a7b60105 100644 (file)
--- 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 ac8062d3e93e32ecb9e3a008b6e4b7d37a2294c2..9c00a7f31d7536411de4e1400beba134db0adbcc 100644 (file)
--- 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