* [binutils-gdb] gas: correct .bss documentation for non-ELF
@ 2024-01-05 7:17 Jan Beulich
0 siblings, 0 replies; only message in thread
From: Jan Beulich @ 2024-01-05 7:17 UTC (permalink / raw)
To: bfd-cvs
https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=8fd892f4dd3c0374582a0b8fd6836ce09529b2b5
commit 8fd892f4dd3c0374582a0b8fd6836ce09529b2b5
Author: Jan Beulich <jbeulich@suse.com>
Date: Fri Jan 5 08:13:09 2024 +0100
gas: correct .bss documentation for non-ELF
Only ELF permits the specification of a subsection, and even there not
consistently: csky, mcore, and spu handle .bss similar to .lcomm.
Diff:
---
gas/doc/as.texi | 13 ++++++++++++-
1 file changed, 12 insertions(+), 1 deletion(-)
diff --git a/gas/doc/as.texi b/gas/doc/as.texi
index bd1f5635b7a..5c48f9caab5 100644
--- a/gas/doc/as.texi
+++ b/gas/doc/as.texi
@@ -4456,7 +4456,12 @@ Some machine configurations provide additional directives.
* Asciz:: @code{.asciz "@var{string}"}@dots{}
* Attach_to_group:: @code{.attach_to_group @var{name}}
* Balign:: @code{.balign [@var{abs-expr}[, @var{abs-expr}]]}
+@ifset ELF
* Bss:: @code{.bss @var{subsection}}
+@end ifset
+@ifclear ELF
+* Bss:: @code{.bss}
+@end ifclear
* Bundle directives:: @code{.bundle_align_mode @var{abs-expr}}, etc
* Byte:: @code{.byte @var{expressions}}
* CFI directives:: @code{.cfi_startproc [simple]}, @code{.cfi_endproc}, etc.
@@ -4801,14 +4806,20 @@ filled in with the value 0x368d (the exact placement of the bytes depends upon
the endianness of the processor). If it skips 1 or 3 bytes, the fill value is
undefined.
+@ifset ELF
@node Bss
@section @code{.bss @var{subsection}}
+@end ifset
+@ifclear ELF
+@node Bss
+@section @code{.bss}
+@end ifclear
@cindex @code{bss} directive
@code{.bss} tells @command{@value{AS}} to assemble the following statements
onto the end of the bss section.
@ifset ELF
-For ELF based targets an optional @var{subsection} expression (which must
+For most ELF based targets an optional @var{subsection} expression (which must
evaluate to a positive integer) can be provided. In this case the statements
are appended to the end of the indicated bss subsection.
@end ifset
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2024-01-05 7:17 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-01-05 7:17 [binutils-gdb] gas: correct .bss documentation for non-ELF Jan Beulich
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).