aboutsummaryrefslogtreecommitdiff
path: root/gcc
diff options
context:
space:
mode:
authorSandra Loosemore <sandra@codesourcery.com>2018-11-12 14:08:37 -0500
committerSandra Loosemore <sandra@gcc.gnu.org>2018-11-12 14:08:37 -0500
commit52ed66ec25474619919be18f3cf8a15cb7f6ea45 (patch)
treeaccb2a8ffe3cf297c9425a4328b2c74a70ad39b4 /gcc
parent6f59f36b9a5dcfbaf3893623f2588f207ddd8cbb (diff)
downloadgcc-52ed66ec25474619919be18f3cf8a15cb7f6ea45.zip
gcc-52ed66ec25474619919be18f3cf8a15cb7f6ea45.tar.gz
gcc-52ed66ec25474619919be18f3cf8a15cb7f6ea45.tar.bz2
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
Diffstat (limited to 'gcc')
-rw-r--r--gcc/ChangeLog7
-rw-r--r--gcc/doc/rtl.texi20
2 files changed, 17 insertions, 10 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 6b4a14b..41b05fb 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 ac8062d..9c00a7f 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