From: Nick Clifton Date: Tue, 18 Jan 2011 13:37:39 +0000 (+0000) Subject: PR gas/12390 X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=7c31ae1375663be74994b1f5fb76b73fd9632cef;p=binutils-gdb.git 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. --- diff --git a/gas/ChangeLog b/gas/ChangeLog index 6d2768b4c98..1b7bf80023a 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,3 +1,51 @@ +2011-01-18 Nick Clifton + + 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 * config/tc-i386.c (cpu_arch): Add CPU_TBM_FLAGS. diff --git a/gas/doc/all.texi b/gas/doc/all.texi index bbf0f6c0cb8..d250b63e1d1 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 1f408e0402d..d9d9ab188e4 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 e634304c8a1..8e2c11b4642 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 3a136a7a04f..ea0fa4eb522 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 e14cc2e0e4b..79a37225b6a 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 d0d0068faf3..14f89796e3a 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 73e2a075094..83d07ca5dd5 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 b6cf10f4438..19f859f71d8 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 7215f193f2f..311277ec8f3 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 731b3441e0f..420311f474a 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 99887657b59..ef3bb6b15b5 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 9970188ab4f..a349d2800f3 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 be4de8a4166..34a69b07bd0 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 22f13778f06..c9594506253 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 14f8c0b08b9..e8a2e61f598 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 bbd8317062e..c33042b4eed 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 146442fdfed..d09fd27dc5b 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 0b65800af53..54ad154c833 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 f863167595a..bebc53ed556 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 26abeced2e5..9d92aa0cdbd 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 be27d2c0547..f1321df2793 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 974a3f097de..fa9ad87aea9 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 6adeaf93114..009f9d3e974 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 09ce9f0e3ab..e5db4076231 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 ca562742b6c..d6d281222a2 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 e61353ab70a..7b6544cc550 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 20e6fc308fb..c5e0c3de9ce 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 542fd13a09f..dcf32ab9399 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 1436604d38d..f0bcbd5df42 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 33ffe1933aa..183fbe385eb 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 ab153120f48..0d629f9ae5b 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 08201154aee..3af20a381dc 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 619f02294b9..438ac5fd5ee 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 ca731257614..8138c1ffa1b 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 7913606385f..3f758adb42c 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 4cfb4405bd7..d61ec3af1a7 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 12d70ba774f..bd451c07c48 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 e92fbed527d..1eb16d773e8 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 ac9a4ea700f..9eacd10d794 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 73866e466f7..cd7688fd321 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 01453dfaaa8..67c6f15055a 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 c52268a8cfb..82cdf80650a 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 269b6124a3a..51f00e1237d 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