diff options
author | Nick Clifton <nickc@redhat.com> | 2011-01-18 13:37:39 +0000 |
---|---|---|
committer | Nick Clifton <nickc@redhat.com> | 2011-01-18 13:37:39 +0000 |
commit | 7c31ae1375663be74994b1f5fb76b73fd9632cef (patch) | |
tree | fc07d7324095e7021798f887c71572923e4be99b /gas/doc/as.texinfo | |
parent | 849afc8b63c64c59371cf6d3dd3bf3d8d9f4cc14 (diff) | |
download | gdb-7c31ae1375663be74994b1f5fb76b73fd9632cef.zip gdb-7c31ae1375663be74994b1f5fb76b73fd9632cef.tar.gz gdb-7c31ae1375663be74994b1f5fb76b73fd9632cef.tar.bz2 |
PR gas/12390
* doc/all.texi: Add NS32K
* doc/as.texinfo: Remove target specific details of which
characters act as comment initiators and statement separators into
individual target specific files.
* doc/c-alpha.texi (Alpha-Chars): Document special behaviour of
the hash character at the start of a line.
* doc/c-arm.texi (ARM-Chars): Likewise.
* doc/c-avr.texi (AVR-Chars): Likewise.
* doc/c-d10v.texi (D10V-Chars): Likewise.
* doc/c-d30v.texi (D30V-Chars): Likewise.
* doc/c-mmix.texi (MMIX-Chars): Likewise.
* doc/c-s390.texi (s390 characters): Likewise.
* doc/c-sh.texi (SH-Chars): Likewise.
* doc/c-sh64.texi (SH64-Chars): Likewise.
* doc/c-sparc.texi (SPARC-Chars): Likewise.
* doc/c-tic6x.texi (TIC6X Syntax): Likewise.
* doc/c-xtensa.texi (Xtensa Syntax): Likewise.
* doc/c-z80.texi (Z80-Chars): Likewise.
* doc/c-z8k.texi (Z8000-Chars): Likewise.
* doc/c-pdp11.texi (PDP11-Syntax): Document line separator character.
* doc/c-arc.texi (ARC-Chars): Fill in this subsection.
* doc/c-bfin.texi (Blackfin Syntax): Document line comment and
line separator characters.
* doc/c-cr16.texi (CR16 Syntax): Likewise.
* doc/c-i386.texi (i386-Chars): Likewise.
* doc/c-i860.texi (i860-Chars): Likewise.
* doc/c-i960.texi (i960-Chars): Likewise.
* doc/c-ip2k.texi (IP2K-Chars): Likewise.
* doc/c-lm32.texi (LM32-Chars): likewise.
* doc/c-m32c.texi (M32C-Chars): Likewise.
* doc/c-m68hc11.texi (M68HC11-syntax): Likewise.
* doc/c-m68k.texi (M68K-Chars): Likewise.
* doc/c-microblaze.texi (MicroBlaze-Chars): Likewise.
* doc/c-msp430.texi (MSP430-Chars): Likewise.
* doc/c-mt.texi (MT-Chars): Likewise.
* doc/c-ns32k.texi (NS32K-Chars): Likewise.
* doc/c-pj.texi (PJ-Chars): Likewise.
* doc/c-ppc.texi (PowerPC-Chars): Likewise.
* doc/c-rx.texi (RX-Chars): Likewise.
* doc/c-score.texi (SCORE-Chars): Likewise.
* doc/c-tic54x.texi (TIC54X-Chars): Likewise.
* doc/c-v850.texi (V850-Chars): Likewise.
* doc/c-vax.texi (VAX-Chars): Likewise.
* doc/c-xc16x.texi (xc16x-Chars): Likewise.
Diffstat (limited to 'gas/doc/as.texinfo')
-rw-r--r-- | gas/doc/as.texinfo | 154 |
1 files changed, 28 insertions, 126 deletions
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo index 1f408e0..d9d9ab1 100644 --- a/gas/doc/as.texinfo +++ b/gas/doc/as.texinfo @@ -1,6 +1,6 @@ \input texinfo @c -*-Texinfo-*- @c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, -@c 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 +@c 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 @c Free Software Foundation, Inc. @c UPDATE!! On future updates-- @c (1) check for new machine-dep cmdline options in @@ -103,7 +103,8 @@ This file documents the GNU Assembler "@value{AS}". @c man begin COPYRIGHT Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, -2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. +2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, +Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 @@ -153,7 +154,8 @@ done. @vskip 0pt plus 1filll Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, -2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. +2000, 2001, 2002, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, +Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 @@ -2236,7 +2238,7 @@ assembler, except that @command{@value{AS}} does not assemble Vax bit-fields. @end ifset @menu -* Preprocessing:: Preprocessing +* Preprocessing:: Preprocessing * Whitespace:: Whitespace * Comments:: Comments * Symbol Intro:: Symbols @@ -2321,98 +2323,18 @@ This means you may not nest these comments. @end smallexample @cindex line comment character -Anything from the @dfn{line comment} character to the next newline -is considered a comment and is ignored. The line comment character is -@ifset ARC -@samp{;} on the ARC; -@end ifset -@ifset ARM -@samp{@@} on the ARM; -@end ifset -@ifset H8/300 -@samp{;} for the H8/300 family; -@end ifset -@ifset HPPA -@samp{;} for the HPPA; -@end ifset -@ifset I80386 -@samp{#} on the i386 and x86-64; -@end ifset -@ifset I960 -@samp{#} on the i960; -@end ifset -@ifset PDP11 -@samp{;} for the PDP-11; -@end ifset -@ifset PJ -@samp{;} for picoJava; -@end ifset -@ifset PPC -@samp{#} for Motorola PowerPC; -@end ifset -@ifset S390 -@samp{#} for IBM S/390; -@end ifset -@ifset SCORE -@samp{#} for the Sunplus SCORE; -@end ifset -@ifset SH -@samp{!} for the Renesas / SuperH SH; -@end ifset -@ifset SPARC -@samp{!} on the SPARC; -@end ifset -@ifset IP2K -@samp{#} on the ip2k; -@end ifset -@ifset M32C -@samp{#} on the m32c; -@end ifset -@ifset M32R -@samp{#} on the m32r; -@end ifset -@ifset M680X0 -@samp{|} on the 680x0; -@end ifset -@ifset M68HC11 -@samp{#} on the 68HC11 and 68HC12; -@end ifset -@ifset RX -@samp{#} on the RX; -@end ifset -@ifset TIC6X -@samp{;} on the TMS320C6X; -@end ifset -@ifset VAX -@samp{#} on the Vax; -@end ifset -@ifset Z80 -@samp{;} for the Z80; -@end ifset -@ifset Z8000 -@samp{!} for the Z8000; -@end ifset -@ifset V850 -@samp{#} on the V850; -@end ifset -@ifset XTENSA -@samp{#} for Xtensa systems; -@end ifset -see @ref{Machine Dependencies}. @refill -@c FIXME What about i860? - -@ifset GENERIC -On some machines there are two different line comment characters. One -character only begins a comment if it is the first non-whitespace character on -a line, while the other always begins a comment. -@end ifset - -@ifset V850 -The V850 assembler also supports a double dash as starting a comment that -extends to the end of the line. - -@samp{--}; -@end ifset +Anything from a @dfn{line comment} character up to the next newline is +considered a comment and is ignored. The line comment character is target +specific, and some targets multiple comment characters. Some targets also have +line comment characters that only work if they are the first character on a +line. Some targets use a sequence of two characters to introduce a line +comment. Some targets can also change their line comment characters depending +upon command line options that have been used. For more details see the +@emph{Syntax} section in the documentation for individual targets. + +If the line comment character is the hash sign (@samp{#}) then it still has the +special ability to enable and disable preprocessing (@pxref{Preprocessing}) and +to specify logical line numbers: @kindex # @cindex lines starting with @code{#} @@ -2470,37 +2392,14 @@ not a possible symbol delimiter). @xref{Symbols}. @cindex statements, structure of @cindex line separator character @cindex statement separator character -@ifclear GENERIC -@ifclear abnormal-separator -A @dfn{statement} ends at a newline character (@samp{\n}) or at a -semicolon (@samp{;}). The newline or semicolon is considered part of -the preceding statement. Newlines and semicolons within character -constants are an exception: they do not end statements. -@end ifclear -@ifset abnormal-separator -@ifset HPPA -A @dfn{statement} ends at a newline character (@samp{\n}) or an exclamation -point (@samp{!}). The newline or exclamation point is considered part of the -preceding statement. Newlines and exclamation points within character -constants are an exception: they do not end statements. -@end ifset -@ifset H8 -A @dfn{statement} ends at a newline character (@samp{\n}); or (for the -H8/300) a dollar sign (@samp{$}); or (for the Renesas-SH) a semicolon -(@samp{;}). The newline or separator character is considered part of -the preceding statement. Newlines and separators within character -constants are an exception: they do not end statements. -@end ifset -@end ifset -@end ifclear -@ifset GENERIC -A @dfn{statement} ends at a newline character (@samp{\n}) or line -separator character. (The line separator is usually @samp{;}, unless this -conflicts with the comment character; see @ref{Machine Dependencies}.) The -newline or separator character is considered part of the preceding -statement. Newlines and separators within character constants are an + +A @dfn{statement} ends at a newline character (@samp{\n}) or a +@dfn{line separator character}. The line separator character is target +specific and described in the @emph{Syntax} section of each +target's documentation. Not all targets support a line separator character. +The newline or line separator character is considered to be part of the +preceding statement. Newlines and separators within character constants are an exception: they do not end statements. -@end ifset @cindex newline, required at file end @cindex EOF, newline must precede @@ -6915,6 +6814,9 @@ subject, see the hardware manufacturer's manual. @ifset MSP430 * MSP430-Dependent:: MSP430 Dependent Features @end ifset +@ifset NS32K +* NS32K-Dependent:: NS32K Dependent Features +@end ifset @ifset SH * SH-Dependent:: Renesas / SuperH SH Dependent Features * SH64-Dependent:: SuperH SH64 Dependent Features |