diff mbox

[3/9] Documentation for the ia16 back end

Message ID 819a3674-db8c-8892-7293-101d156723c5@codesourcery.com
State New
Headers show

Commit Message

Andrew Jenner April 1, 2017, 4:48 p.m. UTC
This patch updates the documentation.

2017-04-01  Andrew Jenner  <andrew@codesourcery.com>
	Rask Ingemann Lambertsen  <rask@sygehus.dk>

	* doc/md.texi: Update for new ia16 back end.
	* doc/invoke.texi: Likewise.
	* doc/contrib.texi: Likewise.
	* doc/install.texi: Likewise.

Comments

Jeff Law April 25, 2017, 4:43 p.m. UTC | #1
On 04/01/2017 10:48 AM, Andrew Jenner wrote:
> This patch updates the documentation.
> 
> 2017-04-01  Andrew Jenner  <andrew@codesourcery.com>
>      Rask Ingemann Lambertsen  <rask@sygehus.dk>
> 
>      * doc/md.texi: Update for new ia16 back end.
>      * doc/invoke.texi: Likewise.
>      * doc/contrib.texi: Likewise.
>      * doc/install.texi: Likewise.
> 
> 
Seems reasonable once the basic port is accepted.

jeff
diff mbox

Patch

Index: gcc/doc/invoke.texi
===================================================================
--- gcc/doc/invoke.texi	(revision 475331)
+++ gcc/doc/invoke.texi	(revision 475455)
@@ -756,6 +756,10 @@  Objective-C and Objective-C++ Dialects}.
 -mschedule=@var{cpu-type}  -mspace-regs  -msio  -mwsio @gol
 -munix=@var{unix-std}  -nolibdld  -static  -threads}

+@emph{IA-16 Options}
+@gccoptlist{-mtune=@var{cpu-type}  -march=@var{cpu-type} -mshort-jumps @gol
+-mseparate-code-segment}
+
 @emph{IA-64 Options}
 @gccoptlist{-mbig-endian  -mlittle-endian  -mgnu-as  -mgnu-ld  -mno-pic @gol
 -mvolatile-asm-stop  -mregister-names  -msdata -mno-sdata @gol
@@ -12782,6 +12786,7 @@  platform.
 * GNU/Linux Options::
 * H8/300 Options::
 * HPPA Options::
+* IA-16 Options::
 * IA-64 Options::
 * LM32 Options::
 * M32C Options::
@@ -16501,6 +16506,71 @@  under HP-UX@.  This option sets flags fo
 linker.
 @end table

+@node IA-16 Options
+@subsection IA-16 Options
+@cindex IA-16 Options
+
+These are the @samp{-m} options defined for the Intel IA-16 architecture.
+
+@table @gcctabopt
+@item -mtune=@var{cpu-type}
+@opindex mtune
+Tune to @var{cpu-type} everything applicable about the generated code, except
+for the ABI and the set of available instructions.  The choices for
+@var{cpu-type} are:
+@table @emph
+@item i8086
+The Intel 8086.
+
+@item i8088
+The Intel 8088.
+
+@item i80186
+The Intel 80186.
+
+@item i80286
+The Intel 80286.
+
+@item v20
+The NEC V20.
+
+@item v30
+The NEC V30.
+
+@item any
+Any CPU listed above.  The aim is to generate code which runs reasonably
+well on any CPU listed above.
+
+@item any_186
+As with @option{-mtune=any}, but assume a CPU which supports immediate
+operands for push, imul and shift/rotate instructions.
+@end table
+
+@item -march=@var{cpu-type}
+@opindex march
+Generate instructions for the machine type @var{cpu-type}.  The choices
+for @var{cpu-type} are the same as for @option{-mtune}.  Moreover,
+specifying @option{-march=@var{cpu-type}} implies
+@option{-mtune=@var{cpu-type}}.
+
+@item -mseparate-code-segment
+@itemx -mno-separate-code-segment
+@opindex mseparate-code-segment
+@opindex mno-separate-code-segment
+Assume (or don't assume) that the code segment may not be the same as the
+data and stack segments. The default is to assume that they are the same
+segment. Currently, trampolines are disabled when using this option.
+
+@item -mshort-jumps
+@itemx -mno-short-jumps
+@opindex mshort-jumps
+@opindex mno-short-jumps
+Allow (or disallow) the use of jump instructions which can only jump
+@minus{}128/+127 bytes.  The default is not to use them.  This option only
+affects instructions for which the assembler doesn't provide a work-around
+and the compiler doesn't know the jump displacement.
+@end table
+
 @node IA-64 Options
 @subsection IA-64 Options
 @cindex IA-64 Options
Index: gcc/doc/contrib.texi
===================================================================
--- gcc/doc/contrib.texi	(revision 475331)
+++ gcc/doc/contrib.texi	(revision 475455)
@@ -524,6 +524,9 @@  Charles LaBrec contributed the support f
 68020 system.

 @item
+Rask Ingemann Lambertsen contributed the 16-bit Intel x86 back end.
+
+@item
 Asher Langton and Mike Kumbera for contributing Cray pointer support
 to GNU Fortran, and for other GNU Fortran improvements.

Index: gcc/doc/md.texi
===================================================================
--- gcc/doc/md.texi	(revision 475331)
+++ gcc/doc/md.texi	(revision 475455)
@@ -2376,6 +2376,120 @@  A memory operand for floating-point load
 A register indirect memory operand
 @end table

+@item Intel IA-16---@file{config/ia16/constraints.md}
+@table @code
+@item a
+The @code{ax} register.
+
+@item b
+The @code{bx} register.
+
+@item c
+The @code{cx} register.
+
+@item d
+The @code{dx} register.
+
+@item S
+The @code{si} register.
+
+@item D
+The @code{di} register.
+
+@item Ral
+The @code{al} register.
+
+@item Rah
+The @code{ah} register.
+
+@item Rcl
+The @code{cl} register.
+
+@item Rbp
+The @code{bp} register.
+
+@item q
+Any 8-bit register.
+
+@item T
+Any general or segment register.
+
+@item A
+The @code{dx:ax} register pair.
+
+@item j
+The @code{bx:dx} register pair.
+
+@item l
+The lower half of pairs of 8-bit registers.
+
+@item u
+The upper half of pairs of 8-bit registers.
+
+@item k
+Any 32-bit register group with access to the two lower bytes.
+
+@item x
+The @code{si} and @code{di} registers.
+
+@item w
+The @code{bx} and @code{bp} registers.
+
+@item B
+The @code{bx}, @code{si}, @code{di} and @code{bp} registers.
+
+@item Q
+Any segment register.
+
+@item Z
+The constant 0.
+
+@item P1
+The constant 1.
+
+@item M1
+The constant @minus{}1.
+
+@item Um
+The constant @minus{}256.
+
+@item Lbm
+The constant 255.
+
+@item Lor
+Constants 128 @dots{} 254.
+
+@item Lom
+Constants 1 @dots{} 254.
+
+@item Lar
+Constants @minus{}255 @dots{} @minus{}129.
+
+@item Lam
+Constants @minus{}255 @dots{} @minus{}2.
+
+@item Uo
+Constants 0xXX00 except @minus{}256.
+
+@item Ua
+Constants 0xXXFF.
+
+@item Ish
+A constant usable as a shift count.
+
+@item Iaa
+A constant multiplier for the @code{aad} instruction.
+
+@item Ipu
+A constant usable with the @code{push} instruction.
+
+@item Imu
+A constant usable with the @code{imul} instruction except 257.
+
+@item I11
+The constant 257.
+@end table
+
 @item Intel IA-64---@file{config/ia64/ia64.h}
 @table @code
 @item a
Index: gcc/doc/install.texi
===================================================================
--- gcc/doc/install.texi	(revision 475331)
+++ gcc/doc/install.texi	(revision 475455)
@@ -3324,6 +3324,12 @@  information have to.
 @item
 @uref{#ix86-x-solaris210,,i?86-*-solaris2.10}
 @item
+@uref{#ix86-x-udk,,i?86-*-udk}
+@item
+@uref{#ia16-x-elf,,ia16-*-elf}
+@item
+@uref{#ia16-x-elks,,ia16-*-elks}
+@item
 @uref{#ia64-x-linux,,ia64-*-linux}
 @item
 @uref{#ia64-x-hpux,,ia64-*-hpux*}
@@ -3966,6 +3972,29 @@  guarantee use of Sun @command{ld}.

 @html
 <hr />
+@end html
+@heading @anchor{ia16-x-elf}ia16-*-elf
+Intel 16-bit x86 processor configuration for embedded systems.
+
+There is no binutils configuration for this target, but binutils
+configurations for @samp{i?86} ELF systems can be used.  Binutils
+releases from around 2001 or later can be used.
+
+
+@html
+<hr />
+@end html
+@heading @anchor{ia16-x-elks}ia16-*-elks
+Intel 16-bit x86 processor configuration for the Embeddable Linux Kernel Subset
+system.
+
+There is no binutils configuration for this target, but binutils
+configurations for @samp{i?86} ELF systems can be used.  Binutils
+releases from around 2001 or later can be used.
+
+
+@html
+<hr />
 @end html
 @anchor{ia64-x-linux}
 @heading ia64-*-linux