* doc/as.texinfo (Local): New description of ELF .local directive.
authorBob Wilson <bob.wilson@acm.org>
Mon, 6 Oct 2008 17:31:39 +0000 (17:31 +0000)
committerBob Wilson <bob.wilson@acm.org>
Mon, 6 Oct 2008 17:31:39 +0000 (17:31 +0000)
gas/ChangeLog
gas/doc/as.texinfo

index 502d2cbd0af62009b57a5eba65e70bc7b1cc48ad..000667f917ee4e02155ddc535be81d1a176a19cd 100644 (file)
@@ -1,3 +1,7 @@
+2008-10-06  Bob Wilson  <bob.wilson@acm.org>
+
+       * doc/as.texinfo (Local): New description of ELF .local directive.
+
 2008-10-06  Nick Clifton  <nickc@redhat.com>
 
        PR 6926
index c0aef5c96c812046405acfefae6cbfb446210f59..457c6387fabc8639016264dd8112aea57ebe07d2 100644 (file)
@@ -3877,6 +3877,9 @@ Some machine configurations provide additional directives.
 * Ln::                          @code{.ln @var{line-number}}
 
 * LNS directives::              @code{.file}, @code{.loc}, etc.
+@ifset ELF
+* Local::                       @code{.local @var{names}}
+@end ifset
 
 * Long::                        @code{.long @var{expressions}}
 @ignore
@@ -5019,6 +5022,22 @@ If @var{val} is non-zero, this tells @command{@value{AS}} to enter MRI mode.  If
 affects code assembled until the next @code{.mri} directive, or until the end
 of the file.  @xref{M, MRI mode, MRI mode}.
 
+@ifset ELF
+@node Local
+@section @code{.local @var{names}}
+
+@cindex @code{local} directive
+This directive, which is available for ELF targets, marks each symbol in
+the comma-separated list of @code{names} as a local symbol so that it
+will not be externally visible.  If the symbols do not already exist,
+they will be created.
+
+For targets where the @code{.lcomm} directive (@pxref{Lcomm}) does not
+accept an alignment argument, which is the case for most ELF targets,
+the @code{.local} directive can be used in combination with @code{.comm}
+(@pxref{Comm}) to define aligned local common data.
+@end ifset
+
 @node List
 @section @code{.list}