summaryrefslogtreecommitdiffstats
path: root/binutils-2.23.52.0.1-as-doc-texinfo-fixes.patch
blob: 688bd5e25368f9feb719a97ce28eaf3082db85a2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
diff -cp ../binutils-2.23.52.0.1.orig/gas/doc/c-arm.texi gas/doc/c-arm.texi
*** ../binutils-2.23.52.0.1.orig/gas/doc/c-arm.texi	2013-03-04 08:25:32.039931945 +0000
--- gas/doc/c-arm.texi	2013-03-04 08:27:37.462927978 +0000
*************** ARM and THUMB instructions had their own
*** 390,418 ****
  @code{unified} syntax, which can be selected via the @code{.syntax}
  directive, and has the following main features:
  
! @table @bullet
! @item
  Immediate operands do not require a @code{#} prefix.
  
! @item
  The @code{IT} instruction may appear, and if it does it is validated
  against subsequent conditional affixes.  In ARM mode it does not
  generate machine code, in THUMB mode it does.
  
! @item
  For ARM instructions the conditional affixes always appear at the end
  of the instruction.  For THUMB instructions conditional affixes can be
  used, but only inside the scope of an @code{IT} instruction.
  
! @item
  All of the instructions new to the V6T2 architecture (and later) are
  available.  (Only a few such instructions can be written in the
  @code{divided} syntax).
  
! @item
  The @code{.N} and @code{.W} suffixes are recognized and honored.
  
! @item
  All instructions set the flags if and only if they have an @code{s}
  affix.
  @end table
--- 390,418 ----
  @code{unified} syntax, which can be selected via the @code{.syntax}
  directive, and has the following main features:
  
! @table @code
! @item 1
  Immediate operands do not require a @code{#} prefix.
  
! @item 2
  The @code{IT} instruction may appear, and if it does it is validated
  against subsequent conditional affixes.  In ARM mode it does not
  generate machine code, in THUMB mode it does.
  
! @item 3
  For ARM instructions the conditional affixes always appear at the end
  of the instruction.  For THUMB instructions conditional affixes can be
  used, but only inside the scope of an @code{IT} instruction.
  
! @item 4
  All of the instructions new to the V6T2 architecture (and later) are
  available.  (Only a few such instructions can be written in the
  @code{divided} syntax).
  
! @item 5
  The @code{.N} and @code{.W} suffixes are recognized and honored.
  
! @item 6
  All instructions set the flags if and only if they have an @code{s}
  affix.
  @end table
*************** Either @samp{#} or @samp{$} can be used
*** 451,478 ****
  @cindex register names, ARM
  *TODO* Explain about ARM register naming, and the predefined names.
  
- @node ARM-Neon-Alignment
- @subsection NEON Alignment Specifiers
- 
- @cindex alignment for NEON instructions
- Some NEON load/store instructions allow an optional address
- alignment qualifier.
- The ARM documentation specifies that this is indicated by
- @samp{@@ @var{align}}. However GAS already interprets
- the @samp{@@} character as a "line comment" start,
- so @samp{: @var{align}} is used instead.  For example:
- 
- @smallexample
-         vld1.8 @{q0@}, [r0, :128]
- @end smallexample
- 
- @node ARM Floating Point
- @section Floating Point
- 
- @cindex floating point, ARM (@sc{ieee})
- @cindex ARM floating point (@sc{ieee})
- The ARM family uses @sc{ieee} floating-point numbers.
- 
  @node ARM-Relocations
  @subsection ARM relocation generation
  
--- 451,456 ----
*************** respectively.  For example to load the 3
*** 519,524 ****
--- 497,524 ----
          MOVT r0, #:upper16:foo
  @end smallexample
  
+ @node ARM-Neon-Alignment
+ @subsection NEON Alignment Specifiers
+ 
+ @cindex alignment for NEON instructions
+ Some NEON load/store instructions allow an optional address
+ alignment qualifier.
+ The ARM documentation specifies that this is indicated by
+ @samp{@@ @var{align}}. However GAS already interprets
+ the @samp{@@} character as a "line comment" start,
+ so @samp{: @var{align}} is used instead.  For example:
+ 
+ @smallexample
+         vld1.8 @{q0@}, [r0, :128]
+ @end smallexample
+ 
+ @node ARM Floating Point
+ @section Floating Point
+ 
+ @cindex floating point, ARM (@sc{ieee})
+ @cindex ARM floating point (@sc{ieee})
+ The ARM family uses @sc{ieee} floating-point numbers.
+ 
  @node ARM Directives
  @section ARM Machine Directives
  
*** ../binutils-2.23.2.orig/gas/doc/c-arc.texi	2013-04-24 11:06:46.573176853 +0100
--- gas/doc/c-arc.texi	2013-04-24 11:13:18.257187711 +0100
*************** The extension instructions are not macro
*** 220,226 ****
  encodings for use of these instructions according to the specification
  by the user.  The parameters are:
  
! @table @bullet
  @item @var{name}
  Name of the extension instruction 
  
--- 220,226 ----
  encodings for use of these instructions according to the specification
  by the user.  The parameters are:
  
! @table @code
  @item @var{name}
  Name of the extension instruction 
  
*** ../binutils-2.23.2.orig/gas/doc/c-cr16.texi	2013-04-24 11:06:46.576176853 +0100
--- gas/doc/c-cr16.texi	2013-04-24 11:14:25.456189574 +0100
*************** Operand expression type qualifier is an
*** 44,69 ****
  CR16 target operand qualifiers and its size (in bits):
  
  @table @samp
! @item Immediate Operand
! - s ---- 4 bits
! @item 
! - m ---- 16 bits, for movb and movw instructions.
! @item 
! - m ---- 20 bits, movd instructions.
! @item 
! - l ---- 32 bits
! 
! @item Absolute Operand
! - s ---- Illegal specifier for this operand.
! @item  
! - m ---- 20 bits, movd instructions.
! 
! @item Displacement Operand
! - s ---- 8 bits
! @item
! - m ---- 16 bits
! @item 
! - l ---- 24 bits
  @end table
  
  For example:
--- 44,76 ----
  CR16 target operand qualifiers and its size (in bits):
  
  @table @samp
! @item Immediate Operand: s
! 4 bits.
! 
! @item Immediate Operand: m
! 16 bits, for movb and movw instructions.
! 
! @item Immediate Operand: m
! 20 bits, movd instructions.
! 
! @item Immediate Operand: l
! 32 bits.
! 
! @item Absolute Operand: s
! Illegal specifier for this operand.
! 
! @item Absolute Operand: m
! 20 bits, movd instructions.
! 
! @item Displacement Operand: s
! 8 bits.
! 
! @item Displacement Operand: m
! 16 bits.
! 
! @item Displacement Operand: l
! 24 bits.
! 
  @end table
  
  For example:
*** ../binutils-2.23.2.orig/gas/doc/c-tic54x.texi	2013-04-24 11:06:46.571176853 +0100
--- gas/doc/c-tic54x.texi	2013-04-24 11:15:13.653190910 +0100
*************** In this example, x is replaced with SYM2
*** 109,115 ****
  is replaced with x.  At this point, x has already been encountered
  and the substitution stops.
  
! @smallexample @code
   .asg   "x",SYM1 
   .asg   "SYM1",SYM2
   .asg   "SYM2",x
--- 109,115 ----
  is replaced with x.  At this point, x has already been encountered
  and the substitution stops.
  
! @smallexample
   .asg   "x",SYM1 
   .asg   "SYM1",SYM2
   .asg   "SYM2",x
*************** Substitution may be forced in situations
*** 126,132 ****
  ambiguous by placing colons on either side of the subsym.  The following
  code: 
  
! @smallexample @code
   .eval  "10",x
  LAB:X:  add     #x, a
  @end smallexample
--- 126,132 ----
  ambiguous by placing colons on either side of the subsym.  The following
  code: 
  
! @smallexample
   .eval  "10",x
  LAB:X:  add     #x, a
  @end smallexample
*************** The @code{LDX} pseudo-op is provided for
*** 309,315 ****
  of a label or address.  For example, if an address @code{_label} resides
  in extended program memory, the value of @code{_label} may be loaded as
  follows:
! @smallexample @code
   ldx     #_label,16,a    ; loads extended bits of _label
   or      #_label,a       ; loads lower 16 bits of _label
   bacc    a               ; full address is in accumulator A
--- 309,315 ----
  of a label or address.  For example, if an address @code{_label} resides
  in extended program memory, the value of @code{_label} may be loaded as
  follows:
! @smallexample
   ldx     #_label,16,a    ; loads extended bits of _label
   or      #_label,a       ; loads lower 16 bits of _label
   bacc    a               ; full address is in accumulator A
diff -cp ../binutils-2.23.2.orig/gas/doc/c-mips.texi gas/doc/c-mips.texi
*** ../binutils-2.23.2.orig/gas/doc/c-mips.texi	2013-04-25 16:43:35.115767923 +0100
--- gas/doc/c-mips.texi	2013-04-26 08:07:10.338304064 +0100
*************** the @samp{mad} and @samp{madu} instructi
*** 234,240 ****
  instructions around accesses to the @samp{HI} and @samp{LO} registers.
  @samp{-no-m4650} turns off this option.
  
! @itemx -m3900
  @itemx -no-m3900
  @itemx -m4100
  @itemx -no-m4100
--- 234,240 ----
  instructions around accesses to the @samp{HI} and @samp{LO} registers.
  @samp{-no-m4650} turns off this option.
  
! @item -m3900
  @itemx -no-m3900
  @itemx -m4100
  @itemx -no-m4100
diff -cp ../binutils-2.23.2.orig/gas/doc/c-score.texi gas/doc/c-score.texi
*** ../binutils-2.23.2.orig/gas/doc/c-score.texi	2013-04-25 16:43:35.043767921 +0100
--- gas/doc/c-score.texi	2013-04-26 08:07:37.975304830 +0100
*************** implicitly with the @code{gp} register.
*** 37,43 ****
  @item -EB
  Assemble code for a big-endian cpu
  
! @itemx -EL
  Assemble code for a little-endian cpu
  
  @item -FIXDD 
--- 37,43 ----
  @item -EB
  Assemble code for a big-endian cpu
  
! @item -EL
  Assemble code for a little-endian cpu
  
  @item -FIXDD 
*************** Assemble code for no warning message for
*** 49,61 ****
  @item -SCORE5
  Assemble code for target is SCORE5
  
! @itemx -SCORE5U
  Assemble code for target is SCORE5U
  
! @itemx -SCORE7
  Assemble code for target is SCORE7, this is default setting
  
! @itemx -SCORE3
  Assemble code for target is SCORE3
  
  @item -march=score7
--- 49,61 ----
  @item -SCORE5
  Assemble code for target is SCORE5
  
! @item -SCORE5U
  Assemble code for target is SCORE5U
  
! @item -SCORE7
  Assemble code for target is SCORE7, this is default setting
  
! @item -SCORE3
  Assemble code for target is SCORE3
  
  @item -march=score7
diff -cp ../binutils-2.23.2.orig/gas/doc/c-tic54x.texi gas/doc/c-tic54x.texi
*** ../binutils-2.23.2.orig/gas/doc/c-tic54x.texi	2013-04-25 16:43:35.042767921 +0100
--- gas/doc/c-tic54x.texi	2013-04-26 08:08:02.418305508 +0100
*************** LAB:X:  add     #x, a
*** 133,139 ****
  
  When assembled becomes:
  
! @smallexample @code
  LAB10  add     #10, a
  @end smallexample
  
--- 133,139 ----
  
  When assembled becomes:
  
! @smallexample 
  LAB10  add     #10, a
  @end smallexample
  
*************** Assign @var{name} the string @var{string
*** 345,351 ****
  performed on @var{string} before assignment.
  
  @cindex @code{eval} directive, TIC54X
! @itemx .eval @var{string}, @var{name}
  Evaluate the contents of string @var{string} and assign the result as a
  string to the subsym @var{name}.  String replacement is performed on
  @var{string} before assignment. 
--- 345,351 ----
  performed on @var{string} before assignment.
  
  @cindex @code{eval} directive, TIC54X
! @item .eval @var{string}, @var{name}
  Evaluate the contents of string @var{string} and assign the result as a
  string to the subsym @var{name}.  String replacement is performed on
  @var{string} before assignment.