Commit: XStormy16: Add GAS documentation

[Nick Clifton <nickc at redhat dot com>]

Hi Guys,

  I am applying the patch below to add the missing GAS documentation for the
  XStormy16 port.  I should have contributed it ages ago - doh!

Cheers
  Nick

gas/ChangeLog
2011-06-20  Nick Clifton  <nickc@redhat.com>

	* doc/Makefile.am: (CPU_DOCS): Add c-xstormy16.texi.
	* doc/Makefile.in: Regenerate.
	* doc/all.texi: Set XSTORMY16.
	* doc/c-xstormy16.texi: New file.

Index: gas/doc/Makefile.am
===================================================================
RCS file: /cvs/src/src/gas/doc/Makefile.am,v
retrieving revision 1.61
diff -u -3 -p -r1.61 Makefile.am
--- gas/doc/Makefile.am	13 Jun 2011 15:18:48 -0000	1.61
+++ gas/doc/Makefile.am	20 Jun 2011 10:23:41 -0000
@@ -70,6 +70,7 @@ CPU_DOCS = \
 	c-tilepro.texi \
 	c-vax.texi \
 	c-v850.texi \
+	c-xstormy16.texi \
 	c-xtensa.texi \
 	c-z80.texi \
 	c-z8k.texi
Index: gas/doc/Makefile.in
===================================================================
RCS file: /cvs/src/src/gas/doc/Makefile.in,v
retrieving revision 1.112
diff -u -3 -p -r1.112 Makefile.in
--- gas/doc/Makefile.in	13 Jun 2011 15:18:48 -0000	1.112
+++ gas/doc/Makefile.in	20 Jun 2011 10:23:42 -0000
@@ -310,6 +310,7 @@ CPU_DOCS = \
 	c-tilepro.texi \
 	c-vax.texi \
 	c-v850.texi \
+	c-xstormy16.texi \
 	c-xtensa.texi \
 	c-z80.texi \
 	c-z8k.texi
Index: gas/doc/all.texi
===================================================================
RCS file: /cvs/src/src/gas/doc/all.texi,v
retrieving revision 1.38
diff -u -3 -p -r1.38 all.texi
--- gas/doc/all.texi	13 Jun 2011 15:18:48 -0000	1.38
+++ gas/doc/all.texi	20 Jun 2011 10:23:42 -0000
@@ -70,6 +70,7 @@
 @set TILEPRO
 @set V850
 @set VAX
+@set XSTORMY16
 @set XTENSA
 @set Z80
 @set Z8000
*** /dev/null	2011-06-20 08:29:10.974000001 +0100
--- gas/doc/c-xstormy16.texi	2011-06-20 11:19:01.058194001 +0100
***************
*** 0 ****
--- 1,104 ----
+ @c Copyright 2010, 2011 Free Software Foundation, Inc.
+ @c This is part of the GAS manual.
+ @c For copying conditions, see the file as.texinfo.
+ 
+ @node XSTORMY16-Dependent
+ @chapter XStormy16 Dependent Features
+ 
+ @cindex XStormy16 support
+ @menu
+ * XStormy16 Syntax::               Syntax
+ * XStormy16 Directives::           Machine Directives
+ * XStormy16 Opcodes::              Pseudo-Opcodes
+ @end menu
+ 
+ @node XStormy16 Syntax
+ @section Syntax
+ @menu
+ * XStormy16-Chars::                Special Characters
+ @end menu
+ 
+ @node XStormy16-Chars
+ @subsection Special Characters
+ 
+ @cindex line comment character, XStormy16
+ @cindex XStormy16 line comment character
+ @samp{#} is the line comment character.  If a @samp{#} appears as the
+ first character of a line, the whole line is treated as a comment, but
+ in this case the line can also be a logical line number directive
+ (@pxref{Comments}) or a preprocessor control command
+ (@pxref{Preprocessing}).
+ 
+ @cindex comment character, XStormy16
+ @cindex XStormy16 comment character
+ A semicolon (@samp{;}) can be used to start a comment that extends
+ from wherever the character appears on the line up to the end of the
+ line.
+ 
+ @cindex line separator, XStormy16
+ @cindex statement separator, XStormy16
+ @cindex XStormy16 line separator
+ 
+ The @samp{|} character can be used to separate statements on the same
+ line.
+ 
+ 
+ @node XStormy16 Directives
+ @section XStormy16 Machine Directives
+ 
+ @cindex machine directives, XStormy16
+ @cindex XStormy16 machine directives
+ @table @code
+ 
+ @cindex @code{16bit_pointers} directive, XStormy16
+ @item .16bit_pointers
+ Like the @option{--16bit-pointers} command line option this directive
+ indicates that the assembly code makes use of 16-bit pointers.
+ 
+ @cindex @code{32bit_pointers} directive, XStormy16
+ @item .32bit_pointers
+ Like the @option{--32bit-pointers} command line option this directive
+ indicates that the assembly code makes use of 32-bit pointers.
+ 
+ @cindex @code{.no_pointers} directive, XStormy16
+ @item .no_pointers
+ Like the @option{--no-pointers} command line option this directive
+ indicates that the assembly code does not makes use pointers.
+ 
+ @end table
+ 
+ @node XStormy16 Opcodes
+ @section XStormy16 Pseudo-Opcodes
+ 
+ @cindex XStormy16 pseudo-opcodes
+ @cindex pseudo-opcodes for XStormy16
+ @code{@value{AS}} implements all the standard XStormy16 opcodes.
+ 
+ @code{@value{AS}} also implements the following pseudo ops:
+ 
+ @table @code
+ 
+ @cindex @code{@@lo} pseudo-op, XStormy16
+ @item @@lo()
+ Computes the lower 16 bits of the given expression and stores it into
+ the immediate operand field of the given instruction.  For example:
+ 
+     @samp{add r6, @@lo(here - there)}
+ 
+ computes the difference between the address of labels 'here' and
+ 'there', takes the lower 16 bits of this difference and adds it to
+ register 6.
+ 
+ @cindex @code{@@hi} pseudo-op, XStormy16
+ @item @@hi()
+ Computes the higher 16 bits of the given expression and stores it into
+ the immediate operand field of the given instruction.  For example:
+ 
+     @samp{addc r7, @@hi(here - there)}
+ 
+ computes the difference between the address of labels 'here' and
+ 'there', takes the upper 16 bits of this difference, shifts it down 16
+ bits and then adds it, along with the carry bit, to the value in
+ register 7.
+ 
+ @end table