aboutsummaryrefslogtreecommitdiff
path: root/gas/doc
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2011-01-18 13:37:39 +0000
committerNick Clifton <nickc@redhat.com>2011-01-18 13:37:39 +0000
commit7c31ae1375663be74994b1f5fb76b73fd9632cef (patch)
treefc07d7324095e7021798f887c71572923e4be99b /gas/doc
parent849afc8b63c64c59371cf6d3dd3bf3d8d9f4cc14 (diff)
downloadgdb-7c31ae1375663be74994b1f5fb76b73fd9632cef.zip
gdb-7c31ae1375663be74994b1f5fb76b73fd9632cef.tar.gz
gdb-7c31ae1375663be74994b1f5fb76b73fd9632cef.tar.bz2
PR gas/12390
* doc/all.texi: Add NS32K * doc/as.texinfo: Remove target specific details of which characters act as comment initiators and statement separators into individual target specific files. * doc/c-alpha.texi (Alpha-Chars): Document special behaviour of the hash character at the start of a line. * doc/c-arm.texi (ARM-Chars): Likewise. * doc/c-avr.texi (AVR-Chars): Likewise. * doc/c-d10v.texi (D10V-Chars): Likewise. * doc/c-d30v.texi (D30V-Chars): Likewise. * doc/c-mmix.texi (MMIX-Chars): Likewise. * doc/c-s390.texi (s390 characters): Likewise. * doc/c-sh.texi (SH-Chars): Likewise. * doc/c-sh64.texi (SH64-Chars): Likewise. * doc/c-sparc.texi (SPARC-Chars): Likewise. * doc/c-tic6x.texi (TIC6X Syntax): Likewise. * doc/c-xtensa.texi (Xtensa Syntax): Likewise. * doc/c-z80.texi (Z80-Chars): Likewise. * doc/c-z8k.texi (Z8000-Chars): Likewise. * doc/c-pdp11.texi (PDP11-Syntax): Document line separator character. * doc/c-arc.texi (ARC-Chars): Fill in this subsection. * doc/c-bfin.texi (Blackfin Syntax): Document line comment and line separator characters. * doc/c-cr16.texi (CR16 Syntax): Likewise. * doc/c-i386.texi (i386-Chars): Likewise. * doc/c-i860.texi (i860-Chars): Likewise. * doc/c-i960.texi (i960-Chars): Likewise. * doc/c-ip2k.texi (IP2K-Chars): Likewise. * doc/c-lm32.texi (LM32-Chars): likewise. * doc/c-m32c.texi (M32C-Chars): Likewise. * doc/c-m68hc11.texi (M68HC11-syntax): Likewise. * doc/c-m68k.texi (M68K-Chars): Likewise. * doc/c-microblaze.texi (MicroBlaze-Chars): Likewise. * doc/c-msp430.texi (MSP430-Chars): Likewise. * doc/c-mt.texi (MT-Chars): Likewise. * doc/c-ns32k.texi (NS32K-Chars): Likewise. * doc/c-pj.texi (PJ-Chars): Likewise. * doc/c-ppc.texi (PowerPC-Chars): Likewise. * doc/c-rx.texi (RX-Chars): Likewise. * doc/c-score.texi (SCORE-Chars): Likewise. * doc/c-tic54x.texi (TIC54X-Chars): Likewise. * doc/c-v850.texi (V850-Chars): Likewise. * doc/c-vax.texi (VAX-Chars): Likewise. * doc/c-xc16x.texi (xc16x-Chars): Likewise.
Diffstat (limited to 'gas/doc')
-rw-r--r--gas/doc/all.texi3
-rw-r--r--gas/doc/as.texinfo154
-rw-r--r--gas/doc/c-alpha.texi7
-rw-r--r--gas/doc/c-arc.texi19
-rw-r--r--gas/doc/c-arm.texi12
-rw-r--r--gas/doc/c-avr.texi12
-rw-r--r--gas/doc/c-bfin.texi12
-rw-r--r--gas/doc/c-cr16.texi27
-rw-r--r--gas/doc/c-d10v.texi9
-rw-r--r--gas/doc/c-d30v.texi11
-rw-r--r--gas/doc/c-h8300.texi2
-rw-r--r--gas/doc/c-hppa.texi2
-rw-r--r--gas/doc/c-i386.texi36
-rw-r--r--gas/doc/c-i860.texi27
-rw-r--r--gas/doc/c-i960.texi28
-rw-r--r--gas/doc/c-ip2k.texi29
-rw-r--r--gas/doc/c-lm32.texi20
-rw-r--r--gas/doc/c-m32c.texi32
-rw-r--r--gas/doc/c-m68hc11.texi22
-rw-r--r--gas/doc/c-m68k.texi31
-rw-r--r--gas/doc/c-microblaze.texi28
-rw-r--r--gas/doc/c-mips.texi28
-rw-r--r--gas/doc/c-mmix.texi7
-rw-r--r--gas/doc/c-msp430.texi16
-rw-r--r--gas/doc/c-mt.texi27
-rw-r--r--gas/doc/c-ns32k.texi46
-rw-r--r--gas/doc/c-pdp11.texi3
-rw-r--r--gas/doc/c-pj.texi26
-rw-r--r--gas/doc/c-ppc.texi33
-rw-r--r--gas/doc/c-rx.texi28
-rw-r--r--gas/doc/c-s390.texi13
-rw-r--r--gas/doc/c-score.texi28
-rw-r--r--gas/doc/c-sh.texi7
-rw-r--r--gas/doc/c-sh64.texi7
-rw-r--r--gas/doc/c-sparc.texi11
-rw-r--r--gas/doc/c-tic54x.texi32
-rw-r--r--gas/doc/c-tic6x.texi7
-rw-r--r--gas/doc/c-v850.texi18
-rw-r--r--gas/doc/c-vax.texi28
-rw-r--r--gas/doc/c-xc16x.texi27
-rw-r--r--gas/doc/c-xtensa.texi9
-rw-r--r--gas/doc/c-z80.texi11
-rw-r--r--gas/doc/c-z8k.texi7
43 files changed, 747 insertions, 195 deletions
diff --git a/gas/doc/all.texi b/gas/doc/all.texi
index bbf0f6c..d250b63 100644
--- a/gas/doc/all.texi
+++ b/gas/doc/all.texi
@@ -1,5 +1,5 @@
@c Copyright 1992, 1993, 1994, 1996, 1997, 1999, 2000, 2001, 2002,
-@c 2003, 2005, 2006, 2007, 2008, 2009, 2010
+@c 2003, 2005, 2006, 2007, 2008, 2009, 2010, 2011
@c Free Software Foundation, Inc.
@c This file is part of the documentation for the GAS manual
@@ -55,6 +55,7 @@
@set MMIX
@set MS1
@set MSP430
+@set NS32K
@set PDP11
@set PJ
@set PPC
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index 1f408e0..d9d9ab1 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -1,6 +1,6 @@
\input texinfo @c -*-Texinfo-*-
@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
-@c 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
+@c 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
@c Free Software Foundation, Inc.
@c UPDATE!! On future updates--
@c (1) check for new machine-dep cmdline options in
@@ -103,7 +103,8 @@ This file documents the GNU Assembler "@value{AS}".
@c man begin COPYRIGHT
Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
-2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation,
+Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
@@ -153,7 +154,8 @@ done.
@vskip 0pt plus 1filll
Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
-2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation,
+Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
@@ -2236,7 +2238,7 @@ assembler, except that @command{@value{AS}} does not assemble Vax bit-fields.
@end ifset
@menu
-* Preprocessing:: Preprocessing
+* Preprocessing:: Preprocessing
* Whitespace:: Whitespace
* Comments:: Comments
* Symbol Intro:: Symbols
@@ -2321,98 +2323,18 @@ This means you may not nest these comments.
@end smallexample
@cindex line comment character
-Anything from the @dfn{line comment} character to the next newline
-is considered a comment and is ignored. The line comment character is
-@ifset ARC
-@samp{;} on the ARC;
-@end ifset
-@ifset ARM
-@samp{@@} on the ARM;
-@end ifset
-@ifset H8/300
-@samp{;} for the H8/300 family;
-@end ifset
-@ifset HPPA
-@samp{;} for the HPPA;
-@end ifset
-@ifset I80386
-@samp{#} on the i386 and x86-64;
-@end ifset
-@ifset I960
-@samp{#} on the i960;
-@end ifset
-@ifset PDP11
-@samp{;} for the PDP-11;
-@end ifset
-@ifset PJ
-@samp{;} for picoJava;
-@end ifset
-@ifset PPC
-@samp{#} for Motorola PowerPC;
-@end ifset
-@ifset S390
-@samp{#} for IBM S/390;
-@end ifset
-@ifset SCORE
-@samp{#} for the Sunplus SCORE;
-@end ifset
-@ifset SH
-@samp{!} for the Renesas / SuperH SH;
-@end ifset
-@ifset SPARC
-@samp{!} on the SPARC;
-@end ifset
-@ifset IP2K
-@samp{#} on the ip2k;
-@end ifset
-@ifset M32C
-@samp{#} on the m32c;
-@end ifset
-@ifset M32R
-@samp{#} on the m32r;
-@end ifset
-@ifset M680X0
-@samp{|} on the 680x0;
-@end ifset
-@ifset M68HC11
-@samp{#} on the 68HC11 and 68HC12;
-@end ifset
-@ifset RX
-@samp{#} on the RX;
-@end ifset
-@ifset TIC6X
-@samp{;} on the TMS320C6X;
-@end ifset
-@ifset VAX
-@samp{#} on the Vax;
-@end ifset
-@ifset Z80
-@samp{;} for the Z80;
-@end ifset
-@ifset Z8000
-@samp{!} for the Z8000;
-@end ifset
-@ifset V850
-@samp{#} on the V850;
-@end ifset
-@ifset XTENSA
-@samp{#} for Xtensa systems;
-@end ifset
-see @ref{Machine Dependencies}. @refill
-@c FIXME What about i860?
-
-@ifset GENERIC
-On some machines there are two different line comment characters. One
-character only begins a comment if it is the first non-whitespace character on
-a line, while the other always begins a comment.
-@end ifset
-
-@ifset V850
-The V850 assembler also supports a double dash as starting a comment that
-extends to the end of the line.
-
-@samp{--};
-@end ifset
+Anything from a @dfn{line comment} character up to the next newline is
+considered a comment and is ignored. The line comment character is target
+specific, and some targets multiple comment characters. Some targets also have
+line comment characters that only work if they are the first character on a
+line. Some targets use a sequence of two characters to introduce a line
+comment. Some targets can also change their line comment characters depending
+upon command line options that have been used. For more details see the
+@emph{Syntax} section in the documentation for individual targets.
+
+If the line comment character is the hash sign (@samp{#}) then it still has the
+special ability to enable and disable preprocessing (@pxref{Preprocessing}) and
+to specify logical line numbers:
@kindex #
@cindex lines starting with @code{#}
@@ -2470,37 +2392,14 @@ not a possible symbol delimiter). @xref{Symbols}.
@cindex statements, structure of
@cindex line separator character
@cindex statement separator character
-@ifclear GENERIC
-@ifclear abnormal-separator
-A @dfn{statement} ends at a newline character (@samp{\n}) or at a
-semicolon (@samp{;}). The newline or semicolon is considered part of
-the preceding statement. Newlines and semicolons within character
-constants are an exception: they do not end statements.
-@end ifclear
-@ifset abnormal-separator
-@ifset HPPA
-A @dfn{statement} ends at a newline character (@samp{\n}) or an exclamation
-point (@samp{!}). The newline or exclamation point is considered part of the
-preceding statement. Newlines and exclamation points within character
-constants are an exception: they do not end statements.
-@end ifset
-@ifset H8
-A @dfn{statement} ends at a newline character (@samp{\n}); or (for the
-H8/300) a dollar sign (@samp{$}); or (for the Renesas-SH) a semicolon
-(@samp{;}). The newline or separator character is considered part of
-the preceding statement. Newlines and separators within character
-constants are an exception: they do not end statements.
-@end ifset
-@end ifset
-@end ifclear
-@ifset GENERIC
-A @dfn{statement} ends at a newline character (@samp{\n}) or line
-separator character. (The line separator is usually @samp{;}, unless this
-conflicts with the comment character; see @ref{Machine Dependencies}.) The
-newline or separator character is considered part of the preceding
-statement. Newlines and separators within character constants are an
+
+A @dfn{statement} ends at a newline character (@samp{\n}) or a
+@dfn{line separator character}. The line separator character is target
+specific and described in the @emph{Syntax} section of each
+target's documentation. Not all targets support a line separator character.
+The newline or line separator character is considered to be part of the
+preceding statement. Newlines and separators within character constants are an
exception: they do not end statements.
-@end ifset
@cindex newline, required at file end
@cindex EOF, newline must precede
@@ -6915,6 +6814,9 @@ subject, see the hardware manufacturer's manual.
@ifset MSP430
* MSP430-Dependent:: MSP430 Dependent Features
@end ifset
+@ifset NS32K
+* NS32K-Dependent:: NS32K Dependent Features
+@end ifset
@ifset SH
* SH-Dependent:: Renesas / SuperH SH Dependent Features
* SH64-Dependent:: SuperH SH64 Dependent Features
diff --git a/gas/doc/c-alpha.texi b/gas/doc/c-alpha.texi
index e634304..8e2c11b 100644
--- a/gas/doc/c-alpha.texi
+++ b/gas/doc/c-alpha.texi
@@ -1,4 +1,4 @@
-@c Copyright 2002, 2003, 2005, 2009
+@c Copyright 2002, 2003, 2005, 2009, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -139,7 +139,10 @@ OpenVMS syntax, with a few differences for ELF.
@cindex line comment character, Alpha
@cindex Alpha line comment character
-@samp{#} is the line comment character.
+@samp{#} is the line comment character. Note that if @samp{#} is the
+first character on a line then it can also be a logical line number
+directive (@pxref{Comments}) or a preprocessor control
+command (@pxref{Preprocessing}).
@cindex line separator, Alpha
@cindex statement separator, Alpha
diff --git a/gas/doc/c-arc.texi b/gas/doc/c-arc.texi
index 3a136a7..ea0fa4e 100644
--- a/gas/doc/c-arc.texi
+++ b/gas/doc/c-arc.texi
@@ -1,4 +1,4 @@
-@c Copyright 2000, 2001, 2005, 2006, 2007 Free Software Foundation, Inc.
+@c Copyright 2000, 2001, 2005, 2006, 2007, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -80,7 +80,6 @@ default.
@end table
-
@node ARC Syntax
@section Syntax
@menu
@@ -91,9 +90,18 @@ default.
@node ARC-Chars
@subsection Special Characters
-@cindex ARC special characters
-@cindex special characters, ARC
-*TODO*
+@cindex line comment character, ARC
+@cindex ARC line comment character
+The presence of a @samp{#} on a line indicates the start of a comment
+that extends to the end of the current line. Note that if a line
+starts with a @samp{#} character then it can also be a logical line
+number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
+@cindex line separator, ARC
+@cindex statement separator, ARC
+@cindex ARC line separator
+The ARC assembler does not support a line separator character.
@node ARC-Regs
@subsection Register Names
@@ -330,4 +338,3 @@ between the two - even for the implicit default core version
For information on the ARC instruction set, see @cite{ARC Programmers
Reference Manual}, ARC International (www.arc.com)
-
diff --git a/gas/doc/c-arm.texi b/gas/doc/c-arm.texi
index e14cc2e..79a3722 100644
--- a/gas/doc/c-arm.texi
+++ b/gas/doc/c-arm.texi
@@ -1,5 +1,5 @@
@c Copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
-@c 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
+@c 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -408,9 +408,13 @@ affix.
@cindex line comment character, ARM
@cindex ARM line comment character
-The presence of a @samp{@@} on a line indicates the start of a comment
-that extends to the end of the current line. If a @samp{#} appears as
-the first character of a line, the whole line is treated as a comment.
+The presence of a @samp{@@} anywhere on a line indicates the start of
+a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
@cindex line separator, ARM
@cindex statement separator, ARM
diff --git a/gas/doc/c-avr.texi b/gas/doc/c-avr.texi
index d0d0068..14f8979 100644
--- a/gas/doc/c-avr.texi
+++ b/gas/doc/c-avr.texi
@@ -1,4 +1,4 @@
-@c Copyright 2006, 2007, 2008, 2009
+@c Copyright 2006, 2007, 2008, 2009, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -114,9 +114,13 @@ This option reject @code{rjmp/rcall} instructions with 8K wrap-around.
@cindex line comment character, AVR
@cindex AVR line comment character
-The presence of a @samp{;} on a line indicates the start of a comment
-that extends to the end of the current line. If a @samp{#} appears as
-the first character of a line, the whole line is treated as a comment.
+The presence of a @samp{;} anywhere on a line indicates the start of a
+comment that extends to the end of that line.
+
+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 line separator, AVR
@cindex statement separator, AVR
diff --git a/gas/doc/c-bfin.texi b/gas/doc/c-bfin.texi
index 73e2a07..83d07ca 100644
--- a/gas/doc/c-bfin.texi
+++ b/gas/doc/c-bfin.texi
@@ -1,4 +1,4 @@
-@c Copyright 2005, 2006, 2009, 2010
+@c Copyright 2005, 2006, 2009, 2010, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -100,6 +100,13 @@ not have embedded spaces. Tokens include numbers, register names,
keywords, user identifiers, and also some multicharacter special
symbols like "+=", "/*" or "||".
+Comments are introduced by the @samp{#} character and extend to the
+end of the current line. If the @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}).
+
@item Instruction Delimiting
A semicolon must terminate every instruction. Sometimes a complete
instruction will consist of more than one operation. There are two
@@ -118,6 +125,9 @@ set off by a "||" token.
a0 = r3.h * r2.l || r1 = [p3++] || r4 = [i2++];
@end smallexample
+Multiple instructions can occour on the same line. Each must be
+terminated by a semicolon character.
+
@item Register Names
The assembler treats register names and instruction keywords in a case
diff --git a/gas/doc/c-cr16.texi b/gas/doc/c-cr16.texi
index b6cf10f..19f859f 100644
--- a/gas/doc/c-cr16.texi
+++ b/gas/doc/c-cr16.texi
@@ -1,4 +1,4 @@
-@c Copyright 2007, 2008 Free Software Foundation, Inc.
+@c Copyright 2007, 2008, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -15,6 +15,7 @@
@cindex CR16 support
@menu
* CR16 Operand Qualifiers:: CR16 Machine Operand Qualifiers
+* CR16 Syntax:: Syntax for the CR16
@end menu
@node CR16 Operand Qualifiers
@@ -90,3 +91,27 @@ For example:
This loads the address of _myfun, shifted right by 1, into global offset table (ie GOT) and its offset value from GOT loads into register-pair r1-r0.
@end example
+
+@node CR16 Syntax
+@section CR16 Syntax
+@menu
+* CR16-Chars:: Special Characters
+@end menu
+
+@node CR16-Chars
+@subsection Special Characters
+
+@cindex line comment character, CR16
+@cindex CR16 line comment character
+The presence of a @samp{#} on a line indicates the start of a comment
+that extends to the end of the current line. If the @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 line separator, CR16
+@cindex statement separator, CR16
+@cindex CR16 line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-d10v.texi b/gas/doc/c-d10v.texi
index 7215f19..311277e 100644
--- a/gas/doc/c-d10v.texi
+++ b/gas/doc/c-d10v.texi
@@ -100,7 +100,14 @@ symbols described in the next section.
@subsection Special Characters
@cindex line comment character, D10V
@cindex D10V line comment character
-@samp{;} and @samp{#} are the line comment characters.
+A semicolon (@samp{;}) can be used anywhere on a line to start a
+comment that extends to the end of the line.
+
+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 could also be a
+logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
@cindex sub-instruction ordering, D10V
@cindex D10V sub-instruction ordering
Sub-instructions may be executed in order, in reverse-order, or in parallel.
diff --git a/gas/doc/c-d30v.texi b/gas/doc/c-d30v.texi
index 731b344..420311f 100644
--- a/gas/doc/c-d30v.texi
+++ b/gas/doc/c-d30v.texi
@@ -1,4 +1,4 @@
-@c Copyright (C) 1997 Free Software Foundation, Inc.
+@c Copyright (C) 1997, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@ifset GENERIC
@@ -98,7 +98,14 @@ symbols described in the next section.
@subsection Special Characters
@cindex line comment character, D30V
@cindex D30V line comment character
-@samp{;} and @samp{#} are the line comment characters.
+A semicolon (@samp{;}) can be used anywhere on a line to start a
+comment that extends to the end of the line.
+
+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 could also be a
+logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
@cindex sub-instruction ordering, D30V
@cindex D30V sub-instruction ordering
Sub-instructions may be executed in order, in reverse-order, or in parallel.
diff --git a/gas/doc/c-h8300.texi b/gas/doc/c-h8300.texi
index 9988765..ef3bb6b 100644
--- a/gas/doc/c-h8300.texi
+++ b/gas/doc/c-h8300.texi
@@ -1,4 +1,4 @@
-@c Copyright (C) 1991, 1992, 1993, 1994, 1995, 2003, 2008
+@c Copyright (C) 1991, 1992, 1993, 1994, 1995, 2003, 2008, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
diff --git a/gas/doc/c-hppa.texi b/gas/doc/c-hppa.texi
index 9970188..a349d28 100644
--- a/gas/doc/c-hppa.texi
+++ b/gas/doc/c-hppa.texi
@@ -1,4 +1,4 @@
-@c Copyright 1991, 1992, 1993, 1994, 1995, 1998, 2004
+@c Copyright 1991, 1992, 1993, 1994, 1995, 1998, 2004, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
diff --git a/gas/doc/c-i386.texi b/gas/doc/c-i386.texi
index be4de8a..34a69b0 100644
--- a/gas/doc/c-i386.texi
+++ b/gas/doc/c-i386.texi
@@ -1,5 +1,5 @@
@c Copyright 1991, 1992, 1993, 1994, 1995, 1997, 1998, 1999, 2000,
-@c 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009
+@c 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -26,7 +26,7 @@ extending the Intel architecture to 64-bits.
@menu
* i386-Options:: Options
* i386-Directives:: X86 specific directives
-* i386-Syntax:: AT&T Syntax versus Intel Syntax
+* i386-Syntax:: Syntactical considerations
* i386-Mnemonics:: Instruction Naming
* i386-Regs:: Register Naming
* i386-Prefixes:: Instruction Prefixes
@@ -261,7 +261,14 @@ This directive is only available for COFF based x86 targets.
@end table
@node i386-Syntax
-@section AT&T Syntax versus Intel Syntax
+@section i386 Syntactical Considerations
+@menu
+* i386-Variations:: AT&T Syntax versus Intel Syntax
+* i386-Chars:: Special Characters
+@end menu
+
+@node i386-Variations
+@subsection AT&T Syntax versus Intel Syntax
@cindex i386 intel_syntax pseudo op
@cindex intel_syntax pseudo op, i386
@@ -362,6 +369,29 @@ The AT&T assembler does not provide support for multiple section
programs. Unix style systems expect all programs to be single sections.
@end itemize
+@node i386-Chars
+@subsection Special Characters
+
+@cindex line comment character, i386
+@cindex i386 line comment character
+The presence of a @samp{#} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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}).
+
+If the @option{--divide} command line option has not been specified
+then the @samp{/} character appearing anywhere on a line also
+introduces a line comment.
+
+@cindex line separator, i386
+@cindex statement separator, i386
+@cindex i386 line separator
+The @samp{;} character can be used to separate statements on the same
+line.
+
@node i386-Mnemonics
@section Instruction Naming
diff --git a/gas/doc/c-i860.texi b/gas/doc/c-i860.texi
index 22f1377..c959450 100644
--- a/gas/doc/c-i860.texi
+++ b/gas/doc/c-i860.texi
@@ -1,4 +1,4 @@
-@c Copyright 2000, 2003 Free Software Foundation, Inc.
+@c Copyright 2000, 2003, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@ifset GENERIC
@@ -22,6 +22,7 @@ that I will add later (jle@cygnus.com).
* Options-i860:: i860 Command-line Options
* Directives-i860:: i860 Machine Directives
* Opcodes for i860:: i860 Opcodes
+* Syntax of i860:: i860 Syntax
@end menu
@node Notes-i860
@@ -170,3 +171,27 @@ andnot (-1 - large_imm)@@l,%r31,%rn
@end smallexample
@end itemize
+@node Syntax of i860
+@section i860 Syntax
+@menu
+* i860-Chars:: Special Characters
+@end menu
+
+@node i860-Chars
+@subsection Special Characters
+
+@cindex line comment character, i860
+@cindex i860 line comment character
+The presence of a @samp{#} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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 line separator, i860
+@cindex statement separator, i860
+@cindex i860 line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-i960.texi b/gas/doc/c-i960.texi
index 14f8c0b..e8a2e61 100644
--- a/gas/doc/c-i960.texi
+++ b/gas/doc/c-i960.texi
@@ -1,4 +1,4 @@
-@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 2002, 2006
+@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 2002, 2006, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -18,6 +18,7 @@
* Floating Point-i960:: Floating Point
* Directives-i960:: i960 Machine Directives
* Opcodes for i960:: i960 Opcodes
+* Syntax of i960:: i960 Syntax
@end menu
@c FIXME! Add Syntax sec with discussion of bitfields here, at least so
@@ -297,3 +298,28 @@ and the instruction pairs they may expand into:
cmpobne& cmpojne& cmpo; bne\cr}
@end tex
@c END TEXI2ROFF-KILL
+
+@node Syntax of i960
+@section Syntax for the i960
+@menu
+* i960-Chars:: Special Characters
+@end menu
+
+@node i960-Chars
+@subsection Special Characters
+
+@cindex line comment character, i960
+@cindex i960 line comment character
+The presence of a @samp{#} on a line indicates the start of a comment
+that extends to the end of the current line.
+
+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 line separator, i960
+@cindex statement separator, i960
+@cindex i960 line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-ip2k.texi b/gas/doc/c-ip2k.texi
index bbd8317..c33042b 100644
--- a/gas/doc/c-ip2k.texi
+++ b/gas/doc/c-ip2k.texi
@@ -1,4 +1,4 @@
-@c Copyright 2002
+@c Copyright 2002, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -15,6 +15,7 @@
@cindex IP2K support
@menu
* IP2K-Opts:: IP2K Options
+* IP2K-Syntax:: IP2K Syntax
@end menu
@node IP2K-Opts
@@ -42,5 +43,29 @@ line option.
This option restores the assembler's default behaviour of not
permitting the extended IP2022 instructions to be assembled.
-
@end table
+
+@node IP2K-Syntax
+@section IP2K Syntax
+@menu
+* IP2K-Chars:: Special Characters
+@end menu
+
+@node IP2K-Chars
+@subsection Special Characters
+
+@cindex line comment character, IP2K
+@cindex IP2K line comment character
+The presence of a @samp{;} on a line indicates the start of a comment
+that extends to the end of the current line.
+
+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 line separator, IP2K
+@cindex statement separator, IP2K
+@cindex IP2K line separator
+The IP2K assembler does not currently support a line separator
+character.
diff --git a/gas/doc/c-lm32.texi b/gas/doc/c-lm32.texi
index 146442f..d09fd27 100644
--- a/gas/doc/c-lm32.texi
+++ b/gas/doc/c-lm32.texi
@@ -1,4 +1,4 @@
-@c Copyright 2008
+@c Copyright 2008, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -72,6 +72,7 @@ Enable all instructions and CSRs.
@menu
* LM32-Regs:: Register Names
* LM32-Modifiers:: Relocatable Expression Modifiers
+* LM32-Chars:: Special Characters
@end menu
@node LM32-Regs
@@ -202,6 +203,23 @@ addi r4, r4, gotofflo16(lsym)
@end table
+@node LM32-Chars
+@subsection Special Characters
+
+@cindex line comment character, LM32
+@cindex LM32 line comment character
+The presence of a @samp{#} on a line indicates the start of a comment
+that extends to the end of the current line. Note that if a line
+starts with a @samp{#} character then it can also be a logical line
+number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
+@cindex line separator, LM32
+@cindex statement separator, LM32
+@cindex LM32 line separator
+A semicolon (@samp{;}) can be used to separate multiple statements on
+the same line.
+
@node LM32 Opcodes
@section Opcodes
diff --git a/gas/doc/c-m32c.texi b/gas/doc/c-m32c.texi
index 0b65800..54ad154 100644
--- a/gas/doc/c-m32c.texi
+++ b/gas/doc/c-m32c.texi
@@ -21,7 +21,7 @@ change the default to the M32C microprocessor.
@menu
* M32C-Opts:: M32C Options
-* M32C-Modifiers:: Symbolic Operand Modifiers
+* M32C-Syntax:: M32C Syntax
@end menu
@node M32C-Opts
@@ -55,11 +55,18 @@ Support H'00 style hex constants in addition to 0x00 style.
@end table
+@node M32C-Syntax
+@section M32C Syntax
+@menu
+* M32C-Modifiers:: Symbolic Operand Modifiers
+* M32C-Chars:: Special Characters
+@end menu
+
@node M32C-Modifiers
-@section Symbolic Operand Modifiers
+@subsection Symbolic Operand Modifiers
@cindex M32C modifiers
-@cindex syntax, M32C
+@cindex modifiers, M32C
The assembler supports several modifiers when using symbol addresses
in M32C instruction operands. The general syntax is the following:
@@ -121,3 +128,22 @@ lde.w [a1a0],r1
@end smallexample
@end table
+
+@node M32C-Chars
+@subsection Special Characters
+
+@cindex line comment character, M32C
+@cindex M32C line comment character
+The presence of a @samp{;} character on a line indicates the start of
+a comment that extends to the end of that line.
+
+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 line separator, M32C
+@cindex statement separator, M32C
+@cindex M32C line separator
+The @samp{|} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-m68hc11.texi b/gas/doc/c-m68hc11.texi
index f863167..bebc53e 100644
--- a/gas/doc/c-m68hc11.texi
+++ b/gas/doc/c-m68hc11.texi
@@ -1,4 +1,5 @@
-@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000, 2003, 2006
+@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000, 2003,
+@c 2006, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -146,6 +147,25 @@ bset 2,x #4
brclr *bot #8 foo
@end smallexample
+@cindex line comment character, M68HC11
+@cindex M68HC11 line comment character
+The presence of a @samp{;} character or a @samp{!} character anywhere
+on a line indicates the start of a comment that extends to the end of
+that line.
+
+A @samp{*} or a @samp{#} character at the start of a line also
+introduces a line comment, but these characters do not work elsewhere
+on the line. If the first character of the line is a @samp{#} then as
+well as starting a comment, the line could also be logical line number
+directive (@pxref{Comments}) or a preprocessor control command
+(@pxref{Preprocessing}).
+
+@cindex line separator, M68HC11
+@cindex statement separator, M68HC11
+@cindex M68HC11 line separator
+The M68HC11 assembler does not currently support a line separator
+character.
+
@cindex M68HC11 addressing modes
@cindex addressing modes, M68HC11
The following addressing modes are understood for 68HC11 and 68HC12:
diff --git a/gas/doc/c-m68k.texi b/gas/doc/c-m68k.texi
index 26abece..9d92aa0 100644
--- a/gas/doc/c-m68k.texi
+++ b/gas/doc/c-m68k.texi
@@ -1,5 +1,5 @@
@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000, 2003,
-@c 2004, 2006, 2007 Free Software Foundation, Inc.
+@c 2004, 2006, 2007, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@ifset GENERIC
@@ -609,14 +609,29 @@ branch instructions allow both word and long displacements.
@subsection Special Characters
@cindex special characters, M680x0
-@cindex M680x0 immediate character
-@cindex immediate character, M680x0
+
@cindex M680x0 line comment character
@cindex line comment character, M680x0
@cindex comments, M680x0
-The immediate character is @samp{#} for Sun compatibility. The
-line-comment character is @samp{|} (unless the @samp{--bitwise-or}
-option is used). If a @samp{#} appears at the beginning of a line, it
-is treated as a comment unless it looks like @samp{# line file}, in
-which case it is treated normally.
+Line comments are introduced by the @samp{|} character appearing
+anywhere on a line, unless the @option{--bitwise-or} command line option
+has been specified.
+
+An asterisk (@samp{*}) as the first character on a line marks the
+start of a line comment as well.
+
+@cindex M680x0 immediate character
+@cindex immediate character, M680x0
+
+A hash character (@samp{#}) as the first character on a line also
+marks the start of a line comment, but in this case it could also be a
+logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}). If the hash character
+appears elsewhere on a line it is used to introduce an immediate
+value. (This is for compatibility with Sun's assembler).
+
+@cindex M680x0 line separator
+@cindex line separator, M680x0
+Multiple statements on the same line can appear if they are separated
+by the @samp{;} character.
diff --git a/gas/doc/c-microblaze.texi b/gas/doc/c-microblaze.texi
index be27d2c..f1321df 100644
--- a/gas/doc/c-microblaze.texi
+++ b/gas/doc/c-microblaze.texi
@@ -1,4 +1,4 @@
-@c Copyright 2009
+@c Copyright 2009, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -22,6 +22,7 @@ Reference Guide (UG081)} available at www.xilinx.com.
@cindex MicroBlaze support
@menu
* MicroBlaze Directives:: Directives for MicroBlaze Processors.
+* MicroBlaze Syntax:: Syntax for the MicroBlaze
@end menu
@node MicroBlaze Directives
@@ -72,3 +73,28 @@ Switch to .bss section. Equivalent to @code{.section .bss}
@item .sbss
Switch to .sbss section. Equivalent to @code{.section .sbss}
@end table
+
+@node MicroBlaze Syntax
+@section Syntax for the MicroBlaze
+@menu
+* MicroBlaze-Chars:: Special Characters
+@end menu
+
+@node MicroBlaze-Chars
+@subsection Special Characters
+
+@cindex line comment character, MicroBlaze
+@cindex MicroBlaze line comment character
+The presence of a @samp{#} on a line indicates the start of a comment
+that extends to the end of the current line.
+
+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 line separator, MicroBlaze
+@cindex statement separator, MicroBlaze
+@cindex MicroBlaze line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-mips.texi b/gas/doc/c-mips.texi
index 974a3f0..fa9ad87 100644
--- a/gas/doc/c-mips.texi
+++ b/gas/doc/c-mips.texi
@@ -1,5 +1,5 @@
@c Copyright 1991, 1992, 1993, 1994, 1995, 1997, 1999, 2000, 2001,
-@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
+@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -33,6 +33,7 @@ Assembly Language Programming'' in the same work.
* MIPS ASE instruction generation overrides:: Directives to control
generation of MIPS ASE instructions
* MIPS floating-point:: Directives to override floating-point options
+* MIPS Syntax:: MIPS specific syntactical considerations
@end menu
@node MIPS Opts
@@ -672,3 +673,28 @@ float-point operations. These directives always override the default
options (@samp{-msingle-float} and @samp{-mdouble-float}).
Traditional @sc{mips} assemblers do not support these directives.
+
+@node MIPS Syntax
+@section Syntactical considerations for the MIPS assembler
+@menu
+* MIPS-Chars:: Special Characters
+@end menu
+
+@node MIPS-Chars
+@subsection Special Characters
+
+@cindex line comment character, MIPS
+@cindex MIPS line comment character
+The presence of a @samp{#} on a line indicates the start of a comment
+that extends to the end of the current line.
+
+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 line separator, MIPS
+@cindex statement separator, MIPS
+@cindex MIPS line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-mmix.texi b/gas/doc/c-mmix.texi
index 6adeaf9..009f9d3 100644
--- a/gas/doc/c-mmix.texi
+++ b/gas/doc/c-mmix.texi
@@ -1,4 +1,4 @@
-@c Copyright 2001, 2002, 2003, 2006 Free Software Foundation, Inc.
+@c Copyright 2001, 2002, 2003, 2006, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@c MMIX description by Hans-Peter Nilsson, hp@bitrange.com
@@ -172,7 +172,10 @@ specified, the rest of the line is ignored, treated as a comment.
The characters @samp{*} and @samp{#} are line comment characters; each
start a comment at the beginning of a line, but only at the beginning of a
line. A @samp{#} prefixes a hexadecimal number if found elsewhere on a
-line.
+line. If a @samp{#} appears at the start of a line the whole line is
+treated as a comment, but the line can also act as a logical line
+number directive (@pxref{Comments}) or a preprocessor control command
+(@pxref{Preprocessing}).
Two other characters, @samp{%} and @samp{!}, each start a comment anywhere
on the line. Thus you can't use the @samp{modulus} and @samp{not}
diff --git a/gas/doc/c-msp430.texi b/gas/doc/c-msp430.texi
index 09ce9f0..e5db407 100644
--- a/gas/doc/c-msp430.texi
+++ b/gas/doc/c-msp430.texi
@@ -1,4 +1,4 @@
-@c Copyright 2002, 2004, 2005 Free Software Foundation, Inc.
+@c Copyright 2002, 2004, 2005, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@ifset GENERIC
@@ -85,7 +85,19 @@ They normally being used as an immediate source operand.
@cindex line comment character, MSP 430
@cindex MSP 430 line comment character
-@samp{;} is the line comment character.
+A semicolon (@samp{;}) appearing anywhere on a line starts a comment
+that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but it can also be a logical line number
+directive (@pxref{Comments}) or a preprocessor control command
+(@pxref{Preprocessing}).
+
+@cindex line separator, MSP 430
+@cindex statement separator, MSP 430
+@cindex MSP 430 line separator
+Multiple statements can appear on the same line provided that they are
+separated by the @samp{@{} character.
@cindex identifiers, MSP 430
@cindex MSP 430 identifiers
diff --git a/gas/doc/c-mt.texi b/gas/doc/c-mt.texi
index ca56274..d6d2812 100644
--- a/gas/doc/c-mt.texi
+++ b/gas/doc/c-mt.texi
@@ -17,6 +17,7 @@
@cindex MT support
@menu
* MT Options:: Options
+* MY Syntax:: Syntax
@end menu
@node MT Options
@@ -42,3 +43,29 @@ and @code{ms2}.
This option disables scheduling restriction checking.
@end table
+
+@node MT Syntax
+@section Syntax
+@menu
+* MT-Chars:: Special Characters
+@end menu
+
+@node MT-Chars
+@subsection Special Characters
+
+@cindex line comment character, MT
+@cindex MT line comment character
+The presence of a @samp{;} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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 line separator, MT
+@cindex statement separator, MT
+@cindex MT line separator
+The MT assembler does not currently support a line separator
+character.
+
diff --git a/gas/doc/c-ns32k.texi b/gas/doc/c-ns32k.texi
index e61353a..7b6544c 100644
--- a/gas/doc/c-ns32k.texi
+++ b/gas/doc/c-ns32k.texi
@@ -29,3 +29,49 @@ only creates single or double precision values. I don't know if the
The 32x32 has no machine dependent directives.
@end ignore
+
+@ifset GENERIC
+@page
+@node NS32K-Dependent
+@chapter NS32K Dependent Features
+@end ifset
+
+@ifclear GENERIC
+@node Machine Dependencies
+@chapter NS32K Dependent Features
+@end ifclear
+
+@cindex N32K support
+@menu
+* NS32K Syntax:: Syntax
+@end menu
+
+
+@node NS32K Syntax
+@section Syntax
+@menu
+* NS32K-Chars:: Special Characters
+@end menu
+
+@node NS32K-Chars
+@subsection Special Characters
+
+@cindex line comment character, NS32K
+@cindex NS32K line comment character
+The presence of a @samp{#} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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}).
+
+If Sequent compatibility has been configured into the assembler then
+the @samp{|} character appearing as the first character on a line will
+also indicate the start of a line comment.
+
+@cindex line separator, NS32K
+@cindex statement separator, NS32K
+@cindex NS32K line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-pdp11.texi b/gas/doc/c-pdp11.texi
index 20e6fc3..c5e0c3d 100644
--- a/gas/doc/c-pdp11.texi
+++ b/gas/doc/c-pdp11.texi
@@ -323,6 +323,9 @@ alternatively @code{fr0} through @code{fr3}.
Comments are started with a @code{#} or a @code{/} character, and extend
to the end of the line. (FIXME: clash with immediates?)
+@cindex PDP-11 line separator
+Multiple statements on the same line can be separated by the @samp{;} character.
+
@node PDP-11-Mnemonics
@section Instruction Naming
diff --git a/gas/doc/c-pj.texi b/gas/doc/c-pj.texi
index 542fd13..dcf32ab 100644
--- a/gas/doc/c-pj.texi
+++ b/gas/doc/c-pj.texi
@@ -1,4 +1,4 @@
-@c Copyright 1999, 2002 Free Software Foundation, Inc.
+@c Copyright 1999, 2002, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@page
@@ -8,6 +8,7 @@
@cindex PJ support
@menu
* PJ Options:: Options
+* PJ Syntax:: PJ Syntax
@end menu
@node PJ Options
@@ -25,4 +26,27 @@ This option selects little endian data output.
This option selects big endian data output.
@end table
+@node PJ Syntax
+@section PJ Syntax
+@menu
+* PJ-Chars:: Special Characters
+@end menu
+
+@node PJ-Chars
+@subsection Special Characters
+
+@cindex line comment character, PJ
+@cindex PJ line comment character
+The presence of a @samp{!} or @samp{/} on a line indicates the start
+of a comment that extends to the end of the current line.
+
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+@cindex line separator, PJ
+@cindex statement separator, PJ
+@cindex PJ line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-ppc.texi b/gas/doc/c-ppc.texi
index 1436604..f0bcbd5 100644
--- a/gas/doc/c-ppc.texi
+++ b/gas/doc/c-ppc.texi
@@ -1,4 +1,4 @@
-@c Copyright 2001, 2002, 2003, 2005, 2006, 2007, 2008, 2009, 2010
+@c Copyright 2001, 2002, 2003, 2005, 2006, 2007, 2008, 2009, 2010, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -16,6 +16,7 @@
@menu
* PowerPC-Opts:: Options
* PowerPC-Pseudo:: PowerPC Assembler Directives
+* PowerPC-Syntax:: PowerPC Syntax
@end menu
@node PowerPC-Opts
@@ -157,3 +158,33 @@ generated. @code{"string"} may be any of the -m cpu selection options
@code{"pop"}. @code{.machine "push"} saves the currently selected
cpu, which may be restored with @code{.machine "pop"}.
@end table
+
+@node PowerPC-Syntax
+@section PowerPC Syntax
+@menu
+* PowerPC-Chars:: Special Characters
+@end menu
+
+@node PowerPC-Chars
+@subsection Special Characters
+
+@cindex line comment character, PowerPC
+@cindex PowerPC line comment character
+The presence of a @samp{#} on a line indicates the start of a comment
+that extends to the end of the current line.
+
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
+If the assembler has been configured for the ppc-*-solaris* target
+then the @samp{!} character also acts as a line comment character.
+This can be disabled via the @option{-mno-solaris} command line
+option.
+
+@cindex line separator, PowerPC
+@cindex statement separator, PowerPC
+@cindex PowerPC line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-rx.texi b/gas/doc/c-rx.texi
index 33ffe19..183fbe3 100644
--- a/gas/doc/c-rx.texi
+++ b/gas/doc/c-rx.texi
@@ -1,4 +1,4 @@
-@c Copyright 2008, 2009
+@c Copyright 2008, 2009, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -18,6 +18,7 @@
* RX-Modifiers:: Symbolic Operand Modifiers
* RX-Directives:: Assembler Directives
* RX-Float:: Floating Point
+* RX-Syntax:: Syntax
@end menu
@node RX-Opts
@@ -143,3 +144,28 @@ the generation of 64-bit floating point constants used the @code{dc.d}
directive instead.
@end table
+
+@node RX-Syntax
+@section Syntax for the RX
+@menu
+* RX-Chars:: Special Characters
+@end menu
+
+@node RX-Chars
+@subsection Special Characters
+
+@cindex line comment character, RX
+@cindex RX line comment character
+The presence of a @samp{;} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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 line separator, RX
+@cindex statement separator, RX
+@cindex RX line separator
+The @samp{!} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-s390.texi b/gas/doc/c-s390.texi
index ab15312..0d629f9 100644
--- a/gas/doc/c-s390.texi
+++ b/gas/doc/c-s390.texi
@@ -1,4 +1,4 @@
-@c Copyright 2009
+@c Copyright 2009, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -94,6 +94,17 @@ register 0 as an address register.
@samp{#} is the line comment character.
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
+@cindex line separator, s390
+@cindex statement separator, s390
+@cindex s390 line separator
+The @samp{;} character can be used instead of a newline to separate
+statements.
+
@node s390 Syntax
@section Instruction syntax
@cindex instruction syntax, s390
diff --git a/gas/doc/c-score.texi b/gas/doc/c-score.texi
index 0820115..3af20a3 100644
--- a/gas/doc/c-score.texi
+++ b/gas/doc/c-score.texi
@@ -1,4 +1,4 @@
-@c Copyright 2009
+@c Copyright 2009, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -16,6 +16,7 @@
@menu
* SCORE-Opts:: Assembler options
* SCORE-Pseudo:: SCORE Assembler Directives
+* SCORE-Syntax:: Syntax
@end menu
@node SCORE-Opts
@@ -140,3 +141,28 @@ Switch the destination of following statements into the bss section,
which is used for data that is uninitialized anywhere.
@end table
+
+@node SCORE-Syntax
+@section SCORE Syntax
+@menu
+* SCORE-Chars:: Special Characters
+@end menu
+
+@node SCORE-Chars
+@subsection Special Characters
+
+@cindex line comment character, SCORE
+@cindex SCORE line comment character
+The presence of a @samp{#} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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 line separator, SCORE
+@cindex statement separator, SCORE
+@cindex SCORE line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-sh.texi b/gas/doc/c-sh.texi
index 619f022..438ac5f 100644
--- a/gas/doc/c-sh.texi
+++ b/gas/doc/c-sh.texi
@@ -1,5 +1,5 @@
@c Copyright 1991, 1992, 1993, 1994, 1995, 1997, 2001, 2003, 2004,
-@c 2005, 2008, 2010 Free Software Foundation, Inc.
+@c 2005, 2008, 2010, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@page
@@ -93,6 +93,11 @@ Support H'00 style hex constants in addition to 0x00 style.
@cindex SH line separator
You can use @samp{;} instead of a newline to separate statements.
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
@cindex symbol names, @samp{$} in
@cindex @code{$} in symbol names
Since @samp{$} has no special meaning, you may use it in symbol names.
diff --git a/gas/doc/c-sh64.texi b/gas/doc/c-sh64.texi
index ca73125..8138c1f 100644
--- a/gas/doc/c-sh64.texi
+++ b/gas/doc/c-sh64.texi
@@ -1,4 +1,4 @@
-@c Copyright (C) 2002, 2003, 2008 Free Software Foundation, Inc.
+@c Copyright (C) 2002, 2003, 2008, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@page
@@ -86,6 +86,11 @@ Support H'00 style hex constants in addition to 0x00 style.
@cindex SH64 line comment character
@samp{!} is the line comment character.
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
@cindex line separator, SH64
@cindex statement separator, SH64
@cindex SH64 line separator
diff --git a/gas/doc/c-sparc.texi b/gas/doc/c-sparc.texi
index 7913606..3f758ad 100644
--- a/gas/doc/c-sparc.texi
+++ b/gas/doc/c-sparc.texi
@@ -1,4 +1,5 @@
-@c Copyright 1991, 1992, 1993, 1994, 1995, 1997, 1999, 2002, 2008
+@c Copyright 1991, 1992, 1993, 1994, 1995, 1997, 1999, 2002, 2008,
+@c 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -131,7 +132,13 @@ for their UltraSPARC and Niagara line of processors.
@cindex line comment character, Sparc
@cindex Sparc line comment character
-@samp{#} is the line comment character.
+A @samp{!} character appearing anywhere on a line indicates the start
+of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
@cindex line separator, Sparc
@cindex statement separator, Sparc
diff --git a/gas/doc/c-tic54x.texi b/gas/doc/c-tic54x.texi
index 4cfb440..d61ec3a 100644
--- a/gas/doc/c-tic54x.texi
+++ b/gas/doc/c-tic54x.texi
@@ -1,4 +1,4 @@
-@c Copyright 2000, 2002, 2003, 2006 Free Software Foundation, Inc.
+@c Copyright 2000, 2002, 2003, 2006, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@c TI TMS320C54X description by Timothy Wall, twall@cygnus.com
@@ -25,6 +25,7 @@
* TIC54X-Directives:: Directives
* TIC54X-Macros:: Macro Features
* TIC54X-MMRegs:: Memory-mapped Registers
+* TIC54X-Syntax:: Syntax
@end menu
@node TIC54X-Opts
@@ -765,3 +766,32 @@ The following symbols are recognized as memory-mapped registers:
@table @code
@end table
+
+@node TIC54X-Syntax
+@section TIC54X Syntax
+@menu
+* TIC54X-Chars:: Special Characters
+@end menu
+
+@node TIC54X-Chars
+@subsection Special Characters
+
+@cindex line comment character, TIC54X
+@cindex TIC54X line comment character
+The presence of a @samp{;} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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}).
+
+The presence of an asterisk (@samp{*}) at the start of a line also
+indicates a comment that extends to the end of that line.
+
+@cindex line separator, TIC54X
+@cindex statement separator, TIC54X
+@cindex TIC54X line separator
+The TIC54X assembler does not currently support a line separator
+character.
+
diff --git a/gas/doc/c-tic6x.texi b/gas/doc/c-tic6x.texi
index 12d70ba..bd451c0 100644
--- a/gas/doc/c-tic6x.texi
+++ b/gas/doc/c-tic6x.texi
@@ -1,4 +1,4 @@
-@c Copyright 2010 Free Software Foundation, Inc.
+@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.
@c man end
@@ -107,7 +107,10 @@ little-endian.
The presence of a @samp{;} on a line indicates the start of a comment
that extends to the end of the current line. If a @samp{#} or
@samp{*} appears as the first character of a line, the whole line is
-treated as a comment.
+treated as a comment. Note that if a line starts with a @samp{#}
+character then it can also be a logical line number directive
+(@pxref{Comments}) or a preprocessor control command
+(@pxref{Preprocessing}).
@cindex line separator, TIC6X
@cindex statement separator, TIC6X
diff --git a/gas/doc/c-v850.texi b/gas/doc/c-v850.texi
index e92fbed..1eb16d7 100644
--- a/gas/doc/c-v850.texi
+++ b/gas/doc/c-v850.texi
@@ -1,4 +1,4 @@
-@c Copyright 1997, 2002, 2003, 2006 Free Software Foundation, Inc.
+@c Copyright 1997, 2002, 2003, 2006, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -103,7 +103,21 @@ attempt to relax them.
@cindex line comment character, V850
@cindex V850 line comment character
-@samp{#} is the 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}).
+
+Two dashes (@samp{--}) can also be used to start a line comment.
+
+@cindex line separator, V850
+@cindex statement separator, V850
+@cindex V850 line separator
+
+The @samp{;} character can be used to separate statements on the same
+line.
+
@node V850-Regs
@subsection Register Names
diff --git a/gas/doc/c-vax.texi b/gas/doc/c-vax.texi
index ac9a4ea..9eacd10 100644
--- a/gas/doc/c-vax.texi
+++ b/gas/doc/c-vax.texi
@@ -1,4 +1,4 @@
-@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1998, 2002
+@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1998, 2002, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -24,6 +24,7 @@
* VAX-branch:: VAX Branch Improvement
* VAX-operands:: VAX Operands
* VAX-no:: Not Supported on VAX
+* VAX-Syntax:: VAX Syntax
@end menu
@@ -356,3 +357,28 @@ separated.
@cindex bitfields, not supported on VAX
Vax bit fields can not be assembled with @code{@value{AS}}. Someone
can add the required code if they really need it.
+
+@node VAX-Syntax
+@section VAX Syntax
+@menu
+* VAX-Chars:: Special Characters
+@end menu
+
+@node VAX-Chars
+@subsection Special Characters
+
+@cindex line comment character, VAX
+@cindex VAX line comment character
+The presence of a @samp{#} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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 line separator, VAX
+@cindex statement separator, VAX
+@cindex VAX line separator
+The @samp{;} character can be used to separate statements on the same
+line.
diff --git a/gas/doc/c-xc16x.texi b/gas/doc/c-xc16x.texi
index 73866e4..cd7688f 100644
--- a/gas/doc/c-xc16x.texi
+++ b/gas/doc/c-xc16x.texi
@@ -1,4 +1,4 @@
-@c Copyright 2006 Free Software Foundation, Inc.
+@c Copyright 2006, 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -9,6 +9,7 @@
@cindex xc16x support
@menu
* xc16x Directives:: xc16x Machine Directives
+* xc16x Syntax:: xc16x Syntax
@end menu
@node xc16x Directives
@@ -53,3 +54,27 @@ aligned to the power of two specified by @var{align}. @var{length} and
differs from @samp{.lcomm} only in that it permits you to specify
an alignment.
@end table
+
+@node xc16x Syntax
+@section xc16x Syntax
+@menu
+* xc16x-Chars:: Special Characters
+@end menu
+
+@node xc16x-Chars
+@subsection Special Characters
+
+@cindex line comment character, xc16x
+@cindex xc16c line comment character
+The presence of a @samp{;} appearing anywhere on a line indicates the
+start of a comment that extends to the end of that line.
+
+If a @samp{#} appears as the first character of a line then 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 line separator, xc16x
+@cindex statement separator, xc16x
+@cindex xc16x line separator
+The XC16X assembler does not support a line separator character.
diff --git a/gas/doc/c-xtensa.texi b/gas/doc/c-xtensa.texi
index 01453df..67c6f15 100644
--- a/gas/doc/c-xtensa.texi
+++ b/gas/doc/c-xtensa.texi
@@ -1,4 +1,4 @@
-@c Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008
+@c Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -105,6 +105,11 @@ multiple times to rename multiple sections.
Block comments are delimited by @samp{/*} and @samp{*/}. End of line
comments may be introduced with either @samp{#} or @samp{//}.
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
Instructions consist of a leading opcode or macro name followed by
whitespace and an optional comma-separated list of operands:
@@ -112,7 +117,7 @@ whitespace and an optional comma-separated list of operands:
@var{opcode} [@var{operand}, @dots{}]
@end smallexample
-Instructions must be separated by a newline or semicolon.
+Instructions must be separated by a newline or semicolon (@samp{;}).
FLIX instructions, which bundle multiple opcodes together in a single
instruction, are specified by enclosing the bundled opcodes inside
diff --git a/gas/doc/c-z80.texi b/gas/doc/c-z80.texi
index c52268a..82cdf80 100644
--- a/gas/doc/c-z80.texi
+++ b/gas/doc/c-z80.texi
@@ -1,3 +1,4 @@
+@c Copyright 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -91,6 +92,16 @@ The suffix @samp{b} denotes a backreference to local label.
@cindex Z80 line comment character
The semicolon @samp{;} is the line comment character;
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
+@cindex line separator, Z80
+@cindex statement separator, Z80
+@cindex Z80 line separator
+The Z80 assembler does not support a line separator character.
+
@cindex location counter, Z80
@cindex hexadecimal prefix, Z80
@cindex Z80 $
diff --git a/gas/doc/c-z8k.texi b/gas/doc/c-z8k.texi
index 269b612..51f00e1 100644
--- a/gas/doc/c-z8k.texi
+++ b/gas/doc/c-z8k.texi
@@ -1,4 +1,4 @@
-@c Copyright 1991, 1992, 1993, 1994, 1995, 2003
+@c Copyright 1991, 1992, 1993, 1994, 1995, 2003, 2011
@c Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@@ -61,6 +61,11 @@ Generate unsegmented code by default.
@cindex Z8000 line comment character
@samp{!} is the line comment character.
+If a @samp{#} appears as the first character of a line then the whole
+line is treated as a comment, but in this case the line could also be
+a logical line number directive (@pxref{Comments}) or a preprocessor
+control command (@pxref{Preprocessing}).
+
@cindex line separator, Z8000
@cindex statement separator, Z8000
@cindex Z8000 line separator