S/390: Implement instruction set extensions
[external/binutils.git] / gas / doc / c-ip2k.texi
1 @c Copyright (C) 2002-2019 Free Software Foundation, Inc.
2 @c This is part of the GAS manual.
3 @c For copying conditions, see the file as.texinfo.
4 @ifset GENERIC
5 @page
6 @node IP2K-Dependent
7 @chapter IP2K Dependent Features
8 @end ifset
9 @ifclear GENERIC
10 @node Machine Dependencies
11 @chapter IP2K Dependent Features
12 @end ifclear
13
14 @cindex IP2K support
15 @menu
16 * IP2K-Opts::                   IP2K Options
17 * IP2K-Syntax::                 IP2K Syntax
18 @end menu
19
20 @node IP2K-Opts
21 @section IP2K Options
22
23 @cindex options, IP2K
24 @cindex IP2K options
25
26 The Ubicom IP2K version of @code{@value{AS}} has a few machine
27 dependent options:
28
29 @table @code
30 @item -mip2022ext
31 @cindex @samp{-mip2022ext} option, IP2022
32 @cindex architecture options, IP2022
33 @cindex IP2K architecture options
34 @code{@value{AS}} can assemble the extended IP2022 instructions, but
35 it will only do so if this is specifically allowed via this command
36 line option.
37
38 @item -mip2022
39 @cindex @samp{-mip2022} option, IP2K
40 @cindex architecture options, IP2K
41 @cindex IP2K architecture options
42 This option restores the assembler's default behaviour of not
43 permitting the extended IP2022 instructions to be assembled.
44
45 @end table
46
47 @node IP2K-Syntax
48 @section IP2K Syntax
49 @menu
50 * IP2K-Chars::                Special Characters
51 @end menu
52
53 @node IP2K-Chars
54 @subsection Special Characters
55
56 @cindex line comment character, IP2K
57 @cindex IP2K line comment character
58 The presence of a @samp{;} on a line indicates the start of a comment
59 that extends to the end of the current line.
60
61 If a @samp{#} appears as the first character of a line, the whole line
62 is treated as a comment, but in this case the line can also be a
63 logical line number directive (@pxref{Comments}) or a preprocessor
64 control command (@pxref{Preprocessing}).
65
66 @cindex line separator, IP2K
67 @cindex statement separator, IP2K
68 @cindex IP2K line separator
69 The IP2K assembler does not currently support a line separator
70 character.