This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
Re: [PATCH v2] .bundle_align_mode
- From: Ryan Mansfield <rmansfield at qnx dot com>
- To: <binutils at sourceware dot org>
- Date: Wed, 14 Mar 2012 08:50:31 -0400
- Subject: Re: [PATCH v2] .bundle_align_mode
- References: <x57jboo1oa7o.fsf@frobland.mtv.corp.google.com>
On 12-03-12 04:06 PM, Roland McGrath wrote:
+@node Bundle directives
+@section @code{.bundle_align_mode @var{abs-expr}}
+@cindex @code{bundle_align_mode} directive
+@cindex bundle
+@cindex instruction bundle
+@cindex aligned instruction bundle
+@code{.bundle_align_mode} enables or disables @defn{aligned instruction
+bundle} mode. In this mode, sequences of adjacent instructions are grouped
+into fixed-sized @defn{bundles}. If the argument is zero, this mode is
+disabled (which is the default state). If the argument it not zero, it
+gives the size of an instruction bundle as a power of two (as for the
+@code{.p2align} directive, @pxref{P2align}).
This appears breaks the docs. e.g.
/home/ryan/gnu/binutils/head/../gas/doc/as.texinfo:4302: Unknown command
`defn'.
Using @dfn instead fixes the build issue.
Regards,
Ryan Mansfield
Index: gas/doc/as.texinfo
===================================================================
RCS file: /cvs/src/src/gas/doc/as.texinfo,v
retrieving revision 1.247
diff -u -r1.247 as.texinfo
--- gas/doc/as.texinfo 13 Mar 2012 16:59:55 -0000 1.247
+++ gas/doc/as.texinfo 14 Mar 2012 12:47:39 -0000
@@ -4299,15 +4299,15 @@
@cindex bundle
@cindex instruction bundle
@cindex aligned instruction bundle
-@code{.bundle_align_mode} enables or disables @defn{aligned instruction
+@code{.bundle_align_mode} enables or disables @dfn{aligned instruction
bundle} mode. In this mode, sequences of adjacent instructions are grouped
-into fixed-sized @defn{bundles}. If the argument is zero, this mode is
-disabled (which is the default state). If the argument it not zero, it
+into fixed-sized @dfn{bundles}. If the argument is zero, this mode is
+disabled (which is the dfault state). If the argument it not zero, it
gives the size of an instruction bundle as a power of two (as for the
@code{.p2align} directive, @pxref{P2align}).
For some targets, it's an ABI requirement that no instruction may span a
-certain aligned boundary. A @defn{bundle} is simply a sequence of
+certain aligned boundary. A @dfn{bundle} is simply a sequence of
instructions that starts on an aligned boundary. For example, if
@var{abs-expr} is @code{5} then the bundle size is 32, so each aligned
chunk of 32 bytes is a bundle. When aligned instruction bundle mode is in
@@ -4332,7 +4332,7 @@
For some targets, it's an ABI requirement that certain instructions may
appear only as part of specified permissible sequences of multiple
instructions, all within the same bundle. A pair of @code{.bundle_lock}
-and @code{.bundle_unlock} directives define a @defn{bundle-locked}
+and @code{.bundle_unlock} directives define a @dfn{bundle-locked}
instruction sequence. For purposes of aligned instruction bundle mode, a
sequence starting with @code{.bundle_lock} and ending with
@code{.bundle_unlock} is treated as a single instruction. That is, the