Unreviewed rtl.texi patch

[Lars Brinkhoff <lars dot spam at nocrew dot org>]

This patch against mainline documents REG_POINTER, and many
undocumented machine modes defined in machmode.def.  I also changed
the spelling of Vax into VAX since that seems more consistent with the
rest of the documentation.

Tested with "make info" and "make dvi" on powerpc-unknown-linux-gnu.

Bits of this patch have previously gone unreviewed as
http://gcc.gnu.org/ml/gcc-patches/2001-02/msg01455.html
http://gcc.gnu.org/ml/gcc-patches/2001-02/msg01515.html
http://gcc.gnu.org/ml/gcc-patches/2001-02/msg01744.html
http://gcc.gnu.org/ml/gcc-patches/2001-04/msg00997.html
http://gcc.gnu.org/ml/gcc-patches/2001-05/msg00444.html
http://gcc.gnu.org/ml/gcc-patches/2001-05/msg01909.html
http://gcc.gnu.org/ml/gcc-patches/2001-06/msg00432.html
http://gcc.gnu.org/ml/gcc-patches/2001-06/msg00766.html

2001-07-23  lars brinkhoff  <lars@nocrew.org>

	* rtl.texi (REG_POINTER): Document.
	(Machine Modes): Document BImode, OImode, PQImode, PHImode,
	QFmode, HFmode, TQFmode, QCmode, and HCmode.

Index: rtl.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/rtl.texi,v
retrieving revision 1.14
diff -c -3 -p -r1.14 rtl.texi
*** rtl.texi	2001/07/20 22:23:25	1.14
--- rtl.texi	2001/07/23 14:00:30
*************** The same hard register may be used also 
*** 430,435 ****
--- 430,443 ----
  functions called by this one, but @code{REG_FUNCTION_VALUE_P} is zero
  in this kind of use.
  
+ @cindex @samp{/f} in RTL dump
+ @findex REG_POINTER
+ @cindex @code{reg} and @samp{/f}
+ @cindex @code{frame_related}, in @code{reg}
+ @item REG_POINTER (@var{x})
+ Nonzero in a @code{reg} if the register holds a pointer.  Stored in the
+ @code{frame_related} field and printed as @samp{/f}.
+ 
  @findex SUBREG_PROMOTED_VAR_P
  @cindex @code{subreg} and @samp{/s}
  @cindex @code{in_struct}, in @code{subreg}
*************** this is the right mode to use for certai
*** 747,759 ****
  @item OImode
  ``Octa Integer'' (?) mode represents a thirty-two-byte integer.
  
  @findex SFmode
  @item SFmode
  ``Single Floating'' mode represents a four byte floating point number.
  In the common case, of a processor with IEEE arithmetic and 8-bit bytes,
  this is a single-precision IEEE floating point number; it can also be
  used for double-precision (on processors with 16-bit bytes) and
! single-precision Vax types.
  
  @findex DFmode
  @item DFmode
--- 755,782 ----
  @item OImode
  ``Octa Integer'' (?) mode represents a thirty-two-byte integer.
  
+ @findex QFmode
+ @item QFmode
+ ``Quarter-Floating'' mode represents a quarter-precision (single byte)
+ floating point number.
+ 
+ @findex HFmode
+ @item HFmode
+ ``Half-Floating'' mode represents a half-precision (two byte) floating
+ point number.
+ 
+ @findex TQFmode
+ @item TQFmode
+ ``Three-Quarter-Floating'' (?) mode represents a three-quarter-precision
+ (three byte) floating point number.
+ 
  @findex SFmode
  @item SFmode
  ``Single Floating'' mode represents a four byte floating point number.
  In the common case, of a processor with IEEE arithmetic and 8-bit bytes,
  this is a single-precision IEEE floating point number; it can also be
  used for double-precision (on processors with 16-bit bytes) and
! single-precision VAX and IBM types.
  
  @findex DFmode
  @item DFmode
*************** For example, RTL expressions of code @co
*** 796,809 ****
  requires.  In debugging dumps of RTL, @code{VOIDmode} is expressed by
  the absence of any mode.
  
  @findex SCmode
  @findex DCmode
  @findex XCmode
  @findex TCmode
! @item SCmode, DCmode, XCmode, TCmode
  These modes stand for a complex number represented as a pair of floating
! point values.  The floating point values are in @code{SFmode},
! @code{DFmode}, @code{XFmode}, and @code{TFmode}, respectively.
  
  @findex CQImode
  @findex CHImode
--- 819,835 ----
  requires.  In debugging dumps of RTL, @code{VOIDmode} is expressed by
  the absence of any mode.
  
+ @findex QCmode
+ @findex HCmode
  @findex SCmode
  @findex DCmode
  @findex XCmode
  @findex TCmode
! @item QCmode, HCmode, SCmode, DCmode, XCmode, TCmode
  These modes stand for a complex number represented as a pair of floating
! point values.  The floating point values are in @code{QFmode},
! @code{HFmode}, @code{SFmode}, @code{DFmode}, @code{XFmode}, and
! @code{TFmode}, respectively.
  
  @findex CQImode
  @findex CHImode
*************** mode classes are:
*** 841,856 ****
  @table @code
  @findex MODE_INT
  @item MODE_INT
! Integer modes.  By default these are @code{QImode}, @code{HImode},
! @code{SImode}, @code{DImode}, and @code{TImode}.
  
  @findex MODE_PARTIAL_INT
  @item MODE_PARTIAL_INT
! The ``partial integer'' modes, @code{PSImode} and @code{PDImode}.
  
  @findex MODE_FLOAT
  @item MODE_FLOAT
! floating point modes.  By default these are @code{SFmode}, @code{DFmode},
  @code{XFmode} and @code{TFmode}.
  
  @findex MODE_COMPLEX_INT
--- 867,885 ----
  @table @code
  @findex MODE_INT
  @item MODE_INT
! Integer modes.  By default these are @code{BImode}, @code{QImode},
! @code{HImode}, @code{SImode}, @code{DImode}, @code{TImode}, and
! @code{OImode}.
  
  @findex MODE_PARTIAL_INT
  @item MODE_PARTIAL_INT
! The ``partial integer'' modes, @code{PQImode}, @code{PHImode},
! @code{PSImode} and @code{PDImode}.
  
  @findex MODE_FLOAT
  @item MODE_FLOAT
! Floating point modes.  By default these are @code{QFmode},
! @code{HFmode}, @code{TQFmode}, @code{SFmode}, @code{DFmode},
  @code{XFmode} and @code{TFmode}.
  
  @findex MODE_COMPLEX_INT
*************** Complex integer modes.  (These are not c
*** 859,866 ****
  
  @findex MODE_COMPLEX_FLOAT
  @item MODE_COMPLEX_FLOAT
! Complex floating point modes.  By default these are @code{SCmode},
! @code{DCmode}, @code{XCmode}, and @code{TCmode}.
  
  @findex MODE_FUNCTION
  @item MODE_FUNCTION
--- 888,896 ----
  
  @findex MODE_COMPLEX_FLOAT
  @item MODE_COMPLEX_FLOAT
! Complex floating point modes.  By default these are @code{QCmode},
! @code{HCmode}, @code{SCmode}, @code{DCmode}, @code{XCmode}, and
! @code{TCmode}.
  
  @findex MODE_FUNCTION
  @item MODE_FUNCTION