This is the mail archive of the
binutils@sources.redhat.com
mailing list for the binutils project.
PATCH: fix COFF-centric GAS subsection documentation
- From: Bob Wilson <bwilson at tensilica dot com>
- To: binutils at sources dot redhat dot com
- Date: Tue, 13 Apr 2004 09:36:22 -0700
- Subject: PATCH: fix COFF-centric GAS subsection documentation
- Organization: Tensilica, Inc.
Someone at Tensilica pointed out an error in the GAS documentation of
subsections. For named sections, both COFF and ELF, the current description
says to use the .section directive to switch subsections. This is incorrect for
ELF, where you must use a separate .subsection directive. Here is a patch to
fix the doc. It also fixes 3 instances of a typo in sections with ELF-specific
directives -- I didn't bother to list these in the ChangeLog entry
OK?
2004-04-13 Bob Wilson <bob.wilson@acm.org>
* doc/as.texinfo (Sub-Sections): Conditionalize COFF-specific use
of .section directive; add a reference to the ELF .subsection
directive.
Index: as.texinfo
===================================================================
RCS file: /cvs/src/src/gas/doc/as.texinfo,v
retrieving revision 1.97
diff -u -r1.97 as.texinfo
--- as.texinfo 23 Mar 2004 23:05:52 -0000 1.97
+++ as.texinfo 13 Apr 2004 16:23:53 -0000
@@ -2983,9 +2983,9 @@
To specify which subsection you want subsequent statements assembled
into, use a numeric argument to specify it, in a @samp{.text
@var{expression}} or a @samp{.data @var{expression}} statement.
-@ifset COFF-ELF
+@ifset COFF
@ifset GENERIC
-When generating COFF or ELF output, you
+When generating COFF output, you
@end ifset
@ifclear GENERIC
You
@@ -2994,6 +2994,16 @@
argument with arbitrary named sections: @samp{.section @var{name},
@var{expression}}.
@end ifset
+@ifset ELF
+@ifset GENERIC
+When generating ELF output, you
+@end ifset
+@ifclear GENERIC
+You
+@end ifclear
+can also use the @code{.subsection} directive (@pxref{SubSection})
+to specify a subsection: @samp{.subsection @var{expression}}.
+@end ifset
@var{Expression} should be an absolute expression.
(@xref{Expressions}.) If you just say @samp{.text} then @samp{.text 0}
is assumed. Likewise @samp{.data} means @samp{.data 0}. Assembly
@@ -4334,7 +4344,7 @@
@cindex @code{hidden} directive
@cindex visibility
-This one of the ELF visibility directives. The other two are
+This is one of the ELF visibility directives. The other two are
@code{.internal} (@pxref{Internal,,@code{.internal}}) and
@code{.protected} (@pxref{Protected,,@code{.protected}}).
@@ -4510,7 +4520,7 @@
@cindex @code{internal} directive
@cindex visibility
-This one of the ELF visibility directives. The other two are
+This is one of the ELF visibility directives. The other two are
@code{.hidden} (@pxref{Hidden,,@code{.hidden}}) and
@code{.protected} (@pxref{Protected,,@code{.protected}}).
@@ -4997,7 +5007,7 @@
@cindex @code{protected} directive
@cindex visibility
-This one of the ELF visibility directives. The other two are
+This is one of the ELF visibility directives. The other two are
@code{.hidden} (@pxref{Hidden}) and @code{.internal} (@pxref{Internal}).
This directive overrides the named symbols default visibility (which is set by