This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
Re: [PATCH 5/6] Add Visium support to gas
- From: Eric Botcazou <ebotcazou at adacore dot com>
- To: Joseph Myers <joseph at codesourcery dot com>
- Cc: binutils at sourceware dot org
- Date: Fri, 05 Dec 2014 13:01:25 +0100
- Subject: Re: [PATCH 5/6] Add Visium support to gas
- Authentication-results: sourceware.org; auth=none
- References: <cover dot 1417646850 dot git dot ebotcazou at gcc dot gnu dot org> <fee07d8c32de19e9586f02a00a656e3628d5f68f dot 1417646850 dot git dot ebotcazou at gcc dot gnu dot org> <alpine dot DEB dot 2 dot 10 dot 1412041513460 dot 23422 at digraph dot polyomino dot org dot uk>
> This patch appears to be missing .texi documentation for machine-specific
> assembler command-line options.
> (<https://sourceware.org/ml/binutils/2010-11/msg00397.html> discusses how
> to arrange such documentation to get it into the relevant places in the
> manual, including the generated manpage, without duplicating it in the
> sources.)
Sorry about that. Attached is the missing patch for gas/doc.
gas/ChangeLog
* doc/Makefile.am (CPU_DOCS): Move c-vax.texi and add c-visium.texi.
* doc/Makefile.in: Regenerate.
* doc/all.texi (CPUs of interest): Add VISIUM.
* doc/as.texinfo (Overview): Add VISIUM case.
(Options): Likewise.
(Machine Dependent Features): Likewise. Reorder entries.
* doc/c-visium.texi: New file.
Makefile.am | 3 ++-
Makefile.in | 3 ++-
all.texi | 1 +
as.texinfo | 56 ++++++++++++++++++++++++++++++++++++++++++--------------
c-visium.texi | 58
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
5 files changed, 105 insertions(+), 16 deletions(-)
--
Eric Botcazou
diff --git a/gas/doc/Makefile.am b/gas/doc/Makefile.am
index c2ddc02..2c179e4 100644
--- a/gas/doc/Makefile.am
+++ b/gas/doc/Makefile.am
@@ -91,8 +91,9 @@ CPU_DOCS = \
c-tic6x.texi \
c-tilegx.texi \
c-tilepro.texi \
- c-vax.texi \
c-v850.texi \
+ c-vax.texi \
+ c-visium.texi \
c-xgate.texi \
c-xstormy16.texi \
c-xtensa.texi \
diff --git a/gas/doc/Makefile.in b/gas/doc/Makefile.in
index 2db5121..4b5f4b7 100644
--- a/gas/doc/Makefile.in
+++ b/gas/doc/Makefile.in
@@ -333,8 +333,9 @@ CPU_DOCS = \
c-tic6x.texi \
c-tilegx.texi \
c-tilepro.texi \
- c-vax.texi \
c-v850.texi \
+ c-vax.texi \
+ c-visium.texi \
c-xgate.texi \
c-xstormy16.texi \
c-xtensa.texi \
diff --git a/gas/doc/all.texi b/gas/doc/all.texi
index 94b88bf..c578000 100644
--- a/gas/doc/all.texi
+++ b/gas/doc/all.texi
@@ -74,6 +74,7 @@
@set TILEPRO
@set V850
@set VAX
+@set VISIUM
@set XGATE
@set XSTORMY16
@set XTENSA
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index 243851b..17ae245 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -529,7 +529,6 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
[@b{-mcpu=54[123589]}|@b{-mcpu=54[56]lp}] [@b{-mfar-mode}|@b{-mf}]
[@b{-merrors-to-file} @var{<filename>}|@b{-me} @var{<filename>}]
@end ifset
-
@ifset TIC6X
@emph{Target TIC6X options:}
@@ -545,7 +544,11 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
@ifset TILEPRO
@c TILEPro has no machine-dependent assembler options
@end ifset
+@ifset VISIUM
+@emph{Target Visium options:}
+ [@b{-mtune=@var{arch}}]
+@end ifset
@ifset XTENSA
@emph{Target Xtensa options:}
@@ -555,7 +558,6 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
[@b{--rename-section} @var{oldname}=@var{newname}]
[@b{--[no-]trampolines}]
@end ifset
-
@ifset Z80
@emph{Target Z80 options:}
@@ -567,8 +569,8 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
[@b{ -forbid-undocumented-instructions}] [@b{-Fud}]
[@b{ -forbid-unportable-instructions}] [@b{-Fup}]
@end ifset
-
@ifset Z8000
+
@c Z8000 has no machine-dependent assembler options
@end ifset
@@ -1638,6 +1640,25 @@ processor.
@end ifset
+@ifset VISIUM
+
+@ifclear man
+@xref{Visium Options}, for the options available when @value{AS} is configured
+for a Visium processor.
+@end ifclear
+
+@ifset man
+@c man begin OPTIONS
+The following option is available when @value{AS} is configured for a Visium
+processor.
+@c man end
+@c man begin INCLUDE
+@include c-visium.texi
+@c ended inside the included file
+@end ifset
+
+@end ifset
+
@ifset XTENSA
@ifclear man
@@ -7268,6 +7289,12 @@ subject, see the hardware manufacturer's manual.
@ifset V850
* V850-Dependent:: V850 Dependent Features
@end ifset
+@ifset VAX
+* Vax-Dependent:: VAX Dependent Features
+@end ifset
+@ifset VISIUM
+* Visium-Dependent:: Visium Dependent Features
+@end ifset
@ifset XGATE
* XGATE-Dependent:: XGATE Features
@end ifset
@@ -7283,9 +7310,6 @@ subject, see the hardware manufacturer's manual.
@ifset Z8000
* Z8000-Dependent:: Z8000 Dependent Features
@end ifset
-@ifset VAX
-* Vax-Dependent:: VAX Dependent Features
-@end ifset
@end menu
@lowersections
@@ -7498,20 +7522,16 @@ family.
@include c-tilepro.texi
@end ifset
-@ifset Z80
-@include c-z80.texi
-@end ifset
-
-@ifset Z8000
-@include c-z8k.texi
+@ifset V850
+@include c-v850.texi
@end ifset
@ifset VAX
@include c-vax.texi
@end ifset
-@ifset V850
-@include c-v850.texi
+@ifset VISIUM
+@include c-visium.texi
@end ifset
@ifset XGATE
@@ -7526,6 +7546,14 @@ family.
@include c-xtensa.texi
@end ifset
+@ifset Z80
+@include c-z80.texi
+@end ifset
+
+@ifset Z8000
+@include c-z8k.texi
+@end ifset
+
@ifset GENERIC
@c reverse effect of @down at top of generic Machine-Dep chapter
@raisesections
diff --git a/gas/doc/c-visium.texi b/gas/doc/c-visium.texi
new file mode 100644
index 0000000..9982608
--- /dev/null
+++ b/gas/doc/c-visium.texi
@@ -0,0 +1,58 @@
+@c Copyright (C) 2014 Free Software Foundation, Inc.
+@c This is part of the GAS manual.
+@c For copying conditions, see the file as.texinfo.
+@c man end
+
+@ifset GENERIC
+@page
+@node Visium-Dependent
+@chapter Visium Dependent Features
+@end ifset
+
+@ifclear GENERIC
+@node Machine Dependencies
+@chapter Visium Dependent Features
+@end ifclear
+
+@cindex Visium support
+@menu
+* Visium Options:: Options
+* Visium Syntax:: Syntax
+@end menu
+
+@node Visium Options
+@section Options
+@cindex Visium options
+@cindex options for Visium
+
+The Visium assembler implements one machine-specific option.
+
+@c man begin OPTIONS
+@table @gcctabopt
+@cindex @code{-mtune=@var{arch}} command line option, Visium
+@item -mtune=@var{arch}
+This option specifies the target architecture. If an attempt is made to
+assemble an instruction that will not execute on the target architecture,
+the assembler will issue an error message.
+
+The following names are recognized:
+@code{mcm24}
+@code{mcm}
+@code{gr5}
+@code{gr6}
+@end table
+@c man end
+
+@node Visium Syntax
+@section Syntax
+
+@menu
+* Visium Registers:: Register Names
+@end menu
+
+@node Visium Registers
+@subsection Register Names
+@cindex Visium registers
+@cindex register names, Visium
+Registers can be specified either by using their canonical mnemonic names
+or by using their alias if they have one, for example @samp{sp}.