CRIS port, part 2: documentation

[Hans-Peter Nilsson <hans-peter dot nilsson at axis dot com>]

Could this be the first port with documentation patches submitted before
being reminded? ;-)

Ok to commit?

Part 2, gcc/doc:

	* doc/invoke.texi: Add CRIS options.
	* doc/install.texi (Specific): Add blurb for CRIS.

Index: doc/install.texi
===================================================================
RCS file: /cvs/gcc/egcs/gcc/doc/install.texi,v
retrieving revision 1.68
diff -p -c -r1.68 install.texi
*** install.texi	2001/09/25 21:17:34	1.68
--- install.texi	2001/09/29 13:33:01
*************** can also be obtained from:
*** 1787,1792 ****
--- 1787,1831 ----
  </p>
  <hr>
  @end html
+ @heading @anchor{cris}CRIS
+ 
+ CRIS is the CPU architecture in Axis Communications ETRAX system-on-a-chip
+ series.  These are used in embedded applications.
+ 
+ @ifnothtml
+ @xref{CRIS Options,, CRIS Options, gcc, Using and Porting the GNU Compiler
+ Collection (GCC)},
+ @end ifnothtml
+ @ifhtml
+ See ``CRIS Options'' in the main manual
+ @end ifhtml
+ for a list of CRIS-specific options.
+ 
+ There are a few different CRIS targets:
+ @table @code
+ @item cris-axis-aout
+ Old target.  Includes a multilib for the @samp{elinux} a.out-based
+ target.  No multilibs for newer architecture variants.
+ @item cris-axis-elf
+ Mainly for monolithic embedded systems.  Includes a multilib for the
+ @samp{v10} core used in @samp{ETRAX 100 LX}.
+ @item cris-axis-linux-gnu
+ A GNU/Linux port for the CRIS architecture, currently targeting
+ @samp{ETRAX 100 LX} by default.
+ @end table
+ 
+ For @code{cris-axis-aout} and @code{cris-axis-elf} you need binutils 2.11
+ or newer.  For @code{cris-axis-linux-gnu} you need binutils 2.12 or newer.
+ 
+ Pre-packaged tools can be obtained from
+ @uref{ftp://ftp.axis.com/pub/axis/tools/cris/compiler-kit/}.  More
+ information about this platform is available at
+ @uref{http://developer.axis.com/}.
+ 
+ @html
+ </p>
+ <hr>
+ @end html
  @heading @anchor{dos}DOS
  
  Please have a look at our @uref{binaries.html,,binaries page}.
Index: doc/invoke.texi
===================================================================
RCS file: /cvs/gcc/egcs/gcc/doc/invoke.texi,v
retrieving revision 1.54
diff -p -c -r1.54 invoke.texi
*** invoke.texi	2001/09/29 10:56:04	1.54
--- invoke.texi	2001/09/29 13:33:18
*************** in the following sections.
*** 585,590 ****
--- 585,599 ----
  -msmall-exec  -mno-small-exec  -mmvcle -mno-mvcle @gol
  -m64 -m31 -mdebug -mno-debug}
  
+ @emph{CRIS Options}
+ @gccoptlist{
+ -mcpu=@var{cpu} -march=@var{cpu} -mtune=@var{cpu} @gol
+ -mmax-stack-frame=@var{n} -melinux-stacksize=@var{n} @gol
+ -metrax4 -metrax100 -mpdebug -mcc-init -mno-side-effects @gol
+ -mstack-align -mdata-align -mconst-align @gol
+ -m32-bit -m16-bit -m8-bit -mno-prologue-epilogue -mno-gotplt @gol
+ -melf -maout -melinux -mlinux -sim -sim2}
+ 
  @item Code Generation Options
  @xref{Code Gen Options,,Options for Code Generation Conventions}.
  @gccoptlist{
*************** that macro, which enables you to change 
*** 5104,5109 ****
--- 5113,5119 ----
  * IA-64 Options::
  * D30V Options::
  * S/390 and zSeries Options::
+ * CRIS Options::
  @end menu
  
  @node M680x0 Options
*************** use a @code{mvc} loop instead.  This is 
*** 9065,9070 ****
--- 9075,9217 ----
  Print (or do not print) additional debug information when compiling.
  The default is to not print debug information.
  
+ @end table
+ 
+ @node CRIS Options
+ @subsection CRIS Options
+ @cindex CRIS Options
+ 
+ These options are defined specifically for the CRIS ports.
+ 
+ @table @gcctabopt
+ @item -march=@var{architecture-type}
+ @itemx -mcpu=@var{architecture-type}
+ @opindex march
+ @opindex mcpu
+ Generate code for the specified architecture.  The choices for
+ @var{architecture-type} are @samp{v3}, @samp{v8} and @samp{v10} for
+ respectively ETRAX@w{ }4, ETRAX@w{ }100, and ETRAX@w{ }100@w{ }LX.
+ Default is @samp{v0} except for cris-axis-linux-gnu, where the default is
+ @samp{v10}.
+ 
+ @item -mtune=@var{architecture-type}
+ @opindex mtune
+ Tune to @var{architecture-type} everything applicable about the generated
+ code, except for the ABI and the set of available instructions.  The
+ choices for @var{architecture-type} are the same as for
+ -march=@var{architecture-type}.
+ 
+ @item -mmax-stack-frame=@var{n}
+ @opindex mmax-stack-frame
+ Warn when the stack frame of a function exceeds @var{n} bytes.
+ 
+ @item -melinux-stacksize=@var{n}
+ @opindex melinux-stacksize
+ Only available with the @samp{cris-axis-aout} target.  Arranges for
+ indications in the program to the kernel loader that the stack of the
+ program should be set to @var{n} bytes.
+ 
+ @item -metrax4
+ @itemx -metrax100
+ @opindex metrax4
+ @opindex metrax100
+ The options @samp{-metrax4} and @samp{-metrax100} are synonyms for
+ @samp{-march=v3} and @samp{-march=v8} respectively.
+ 
+ @item -mpdebug
+ @opindex mpdebug
+ Enable CRIS-specific verbose debug-related information in the assembly
+ code.  This option also has the effect to turn off the @samp{#NO_APP}
+ formatted-code indicator to the assembler at the beginning of the
+ assembly file.
+ 
+ @item -mcc-init
+ @opindex mcc-init
+ Do not use condition-code results from previous instruction; always emit
+ compare and test instructions before use of condition codes.
+ 
+ @item -mno-side-effects
+ @opindex mno-side-effects
+ Do not emit instructions with side-effects in addressing modes other than
+ post-increment.
+ 
+ @item -mstack-align
+ @itemx -mno-stack-align
+ @itemx -mdata-align
+ @itemx -mno-data-align
+ @itemx -mconst-align
+ @itemx -mno-const-align
+ @opindex mstack-align
+ @opindex mno-stack-align
+ @opindex mdata-align
+ @opindex mno-data-align
+ @opindex mconst-align
+ @opindex mno-const-align
+ These options (no-options) arranges (eliminate arrangements) for the
+ stack-frame, individual data and constants to be aligned for the maximum
+ single data access size for the chosen CPU model.  The default is to
+ arrange for 32-bit alignment.  ABI details such as structure layout are
+ not affected by these options.
+ 
+ @item -m32-bit
+ @itemx -m16-bit
+ @itemx -m8-bit
+ @opindex m32-bit
+ @opindex m16-bit
+ @opindex m8-bit
+ Similar to the stack- data- and const-align options above, these options
+ arrange for stack-frame, writable data and constants to all be 32-bit,
+ 16-bit or 8-bit aligned.  The default is 32-bit alignment.
+ 
+ @item -mno-prologue-epilogue
+ @itemx -mprologue-epilogue
+ @opindex mno-prologue-epilogue
+ @opindex mprologue-epilogue
+ With @samp{-mno-prologue-epilogue}, the normal function prologue and
+ epilogue that sets up the stack-frame are omitted and no return
+ instructions or return sequences are generated in the code.  Use this
+ option only together with visual inspection of the compiled code: no
+ warnings or errors are generated when call-saved registers must be saved,
+ or storage for local variable needs to be allocated.
+ 
+ @item -mno-gotplt
+ @itemx -mgotplt
+ @opindex mno-gotplt
+ @opindex mgotplt
+ With @samp{-fpic} and @samp{-fPIC}, don't generate (do generate)
+ instruction sequences that load addresses for functions from the PLT part
+ of the GOT rather than (traditional on other architectures) calls to the
+ PLT.  The default is @samp{-mgotplt}.
+ 
+ @item -maout
+ @opindex maout
+ Legacy no-op option only recognized with the cris-axis-aout target.
+ 
+ @item -melf
+ @opindex melf
+ Legacy no-op option only recognized with the cris-axis-elf and
+ cris-axis-linux-gnu targets.
+ 
+ @item -melinux
+ @opindex melinux
+ Only recognized with the cris-axis-aout target, where it selects a
+ GNU/linux-like multilib, include files and instruction set for
+ @samp{-march=v8}.
+ 
+ @item -mlinux
+ @opindex mlinux
+ Legacy no-op option only recognized with the cris-axis-linux-gnu target.
+ 
+ @item -sim
+ @opindex sim
+ This option, recognized for the cris-axis-aout and cris-axis-elf arranges
+ to link with input-output functions from a simulator library.  Code,
+ initialized data and zero-initialized data are allocated consecutively.
+ 
+ @item -sim2
+ @opindex sim2
+ Like @samp{-sim}, but pass linker options to locate initialized data at
+ 0x40000000 and zero-initialized data at 0x80000000.
  @end table
  
  
brgds, H-P