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.

44 files changed, 795 insertions, 195 deletions

diff --git a/gas/ChangeLog b/gas/ChangeLog
index 6d2768b..1b7bf80 100644
--- a/gas/ChangeLog
+++ b/gas/ChangeLog
@@ -1,3 +1,51 @@
+2011-01-18  Nick Clifton  <nickc@redhat.com>
+
+	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.
+
 2011-01-17  Quentin Neill  <quentin.neill@amd.com>
 
 	* config/tc-i386.c (cpu_arch): Add CPU_TBM_FLAGS.
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