+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.
@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
@set MMIX
@set MS1
@set MSP430
+@set NS32K
@set PDP11
@set PJ
@set PPC
\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
@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
@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
@end ifset
@menu
-* Preprocessing:: Preprocessing
+* Preprocessing:: Preprocessing
* Whitespace:: Whitespace
* Comments:: Comments
* Symbol Intro:: Symbols
@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{#}
@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
@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
-@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.
@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
-@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.
@end table
-
@node ARC Syntax
@section Syntax
@menu
@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
For information on the ARC instruction set, see @cite{ARC Programmers
Reference Manual}, ARC International (www.arc.com)
-
@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.
@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
-@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.
@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
-@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.
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
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
-@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.
@cindex CR16 support
@menu
* CR16 Operand Qualifiers:: CR16 Machine Operand Qualifiers
+* CR16 Syntax:: Syntax for the CR16
@end menu
@node CR16 Operand Qualifiers
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.
@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.
-@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
@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.
-@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.
-@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.
@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.
@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
@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
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
-@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
* 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
@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.
-@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.
* 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
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.
-@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.
@cindex IP2K support
@menu
* IP2K-Opts:: IP2K Options
+* IP2K-Syntax:: IP2K Syntax
@end menu
@node IP2K-Opts
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.
-@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.
@menu
* LM32-Regs:: Register Names
* LM32-Modifiers:: Relocatable Expression Modifiers
+* LM32-Chars:: Special Characters
@end menu
@node LM32-Regs
@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
@menu
* M32C-Opts:: M32C Options
-* M32C-Modifiers:: Symbolic Operand Modifiers
+* M32C-Syntax:: M32C Syntax
@end menu
@node M32C-Opts
@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:
@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.
-@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.
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:
@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
@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.
-@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.
@cindex MicroBlaze support
@menu
* MicroBlaze Directives:: Directives for MicroBlaze Processors.
+* MicroBlaze Syntax:: Syntax for the MicroBlaze
@end menu
@node MicroBlaze Directives
@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.
@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.
* 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
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.
-@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
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}
-@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
@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
@cindex MT support
@menu
* MT Options:: Options
+* MY Syntax:: Syntax
@end menu
@node MT Options
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.
+
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.
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
-@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
@cindex PJ support
@menu
* PJ Options:: Options
+* PJ Syntax:: PJ Syntax
@end menu
@node PJ Options
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.
-@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.
@menu
* PowerPC-Opts:: Options
* PowerPC-Pseudo:: PowerPC Assembler Directives
+* PowerPC-Syntax:: PowerPC Syntax
@end menu
@node PowerPC-Opts
@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.
-@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.
* RX-Modifiers:: Symbolic Operand Modifiers
* RX-Directives:: Assembler Directives
* RX-Float:: Floating Point
+* RX-Syntax:: Syntax
@end menu
@node RX-Opts
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.
-@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.
@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
-@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.
@menu
* SCORE-Opts:: Assembler options
* SCORE-Pseudo:: SCORE Assembler Directives
+* SCORE-Syntax:: Syntax
@end menu
@node SCORE-Opts
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.
@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
@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.
-@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
@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
-@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.
@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
-@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
* TIC54X-Directives:: Directives
* TIC54X-Macros:: Macro Features
* TIC54X-MMRegs:: Memory-mapped Registers
+* TIC54X-Syntax:: Syntax
@end menu
@node TIC54X-Opts
@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.
+
-@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
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
-@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.
@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
-@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.
* VAX-branch:: VAX Branch Improvement
* VAX-operands:: VAX Operands
* VAX-no:: Not Supported on VAX
+* VAX-Syntax:: VAX Syntax
@end menu
@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.
-@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.
@cindex xc16x support
@menu
* xc16x Directives:: xc16x Machine Directives
+* xc16x Syntax:: xc16x Syntax
@end menu
@node xc16x Directives
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.
-@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.
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:
@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
+@c Copyright 2011 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@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 $
-@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.
@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
projects / external / binutils.git / commitdiff