aboutsummaryrefslogtreecommitdiff
path: root/gas/doc
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2009-07-23 10:19:20 +0000
committerNick Clifton <nickc@redhat.com>2009-07-23 10:19:20 +0000
commita946d7e38e4e55fb6b71f71d896e83c39ac404fa (patch)
tree273b703f223df3765b56f0247ab4545646c94fbf /gas/doc
parent249b2a84f4763409d444feba4570a600af398094 (diff)
downloadgdb-a946d7e38e4e55fb6b71f71d896e83c39ac404fa.zip
gdb-a946d7e38e4e55fb6b71f71d896e83c39ac404fa.tar.gz
gdb-a946d7e38e4e55fb6b71f71d896e83c39ac404fa.tar.bz2
PR binutils/10379
* doc/c-mips.texi (MIPS insn): Document the special behaviour of the .global directive for MIPS ports.
Diffstat (limited to 'gas/doc')
-rw-r--r--gas/doc/c-mips.texi26
1 files changed, 26 insertions, 0 deletions
diff --git a/gas/doc/c-mips.texi b/gas/doc/c-mips.texi
index 695176b..9c5c522 100644
--- a/gas/doc/c-mips.texi
+++ b/gas/doc/c-mips.texi
@@ -527,6 +527,32 @@ when loading the address of a label which precedes instructions,
@code{@value{AS}} automatically adds 1 to the value, so that jumping to
the loaded address will do the right thing.
+@kindex @code{.global}
+The @code{.global} and @code{.globl} directives supported by
+@code{@value{AS}} will by default mark the symbol as pointing to a
+region of data not code. This means that, for example, any
+instructions following such a symbol will not be disassembled by
+@code{@value{objdump}} as it will regard them as data. To change this
+behaviour an optional section name can be placed after the symbol name
+in the @code{.global} directive. If this section exists and is known
+to be a code section, then the symbol will be marked as poiting at
+code not data. Ie the syntax for the directive is:
+
+ @code{.global @var{symbol}[ @var{section}][, @var{symbol}[ @var{section}]] ...},
+
+Here is a short example:
+
+@example
+ .global foo .text, bar, baz .data
+foo:
+ nop
+bar:
+ .word 0x0
+baz:
+ .word 0x1
+
+@end example
+
@node MIPS option stack
@section Directives to save and restore options