From 2d8b84aee37fb51ffe5b3f8e5b6941fc21821984 Mon Sep 17 00:00:00 2001 From: Sterling Augustine Date: Tue, 23 Nov 2010 19:19:38 +0000 Subject: 2010-11-23 Sterling Augustine * doc/as.texinfo: Refer to and include c-xtensa.texi for Xtensa options. Move Xtensa options to proper alphabetical location. * doc/c-xtensa.texi: Add markup for use in manpage generation. --- gas/doc/as.texinfo | 70 +++++++++++++++++++-------------------------------- gas/doc/c-xtensa.texi | 8 +++--- 2 files changed, 31 insertions(+), 47 deletions(-) (limited to 'gas/doc') diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo index bddd93c..a981814 100644 --- a/gas/doc/as.texinfo +++ b/gas/doc/as.texinfo @@ -480,6 +480,15 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. [@b{-mpid=no}|@b{-mpid=near}|@b{-mpid=far}] [@b{-mpic}|@b{-mno-pic}] @end ifset +@ifset XTENSA + +@emph{Target Xtensa options:} + [@b{--[no-]text-section-literals}] [@b{--[no-]absolute-literals}] + [@b{--[no-]target-align}] [@b{--[no-]longcalls}] + [@b{--[no-]transform}] + [@b{--rename-section} @var{oldname}=@var{newname}] +@end ifset + @ifset Z80 @emph{Target Z80 options:} @@ -495,14 +504,7 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. @ifset Z8000 @c Z8000 has no machine-dependent assembler options @end ifset -@ifset XTENSA -@emph{Target Xtensa options:} - [@b{--[no-]text-section-literals}] [@b{--[no-]absolute-literals}] - [@b{--[no-]target-align}] [@b{--[no-]longcalls}] - [@b{--[no-]transform}] - [@b{--rename-section} @var{oldname}=@var{newname}] -@end ifset @c man end @end smallexample @@ -1324,47 +1326,27 @@ TMS320C6000 processor. @end ifset -@c man begin OPTIONS @ifset XTENSA -The following options are available when @value{AS} is configured for -an Xtensa processor. -@table @gcctabopt -@item --text-section-literals | --no-text-section-literals -With @option{--text-@-section-@-literals}, literal pools are interspersed -in the text section. The default is -@option{--no-@-text-@-section-@-literals}, which places literals in a -separate section in the output file. These options only affect literals -referenced via PC-relative @code{L32R} instructions; literals for -absolute mode @code{L32R} instructions are handled separately. - -@item --absolute-literals | --no-absolute-literals -Indicate to the assembler whether @code{L32R} instructions use absolute -or PC-relative addressing. The default is to assume absolute addressing -if the Xtensa processor includes the absolute @code{L32R} addressing -option. Otherwise, only the PC-relative @code{L32R} mode can be used. - -@item --target-align | --no-target-align -Enable or disable automatic alignment to reduce branch penalties at the -expense of some code density. The default is @option{--target-@-align}. - -@item --longcalls | --no-longcalls -Enable or disable transformation of call instructions to allow calls -across a greater range of addresses. The default is -@option{--no-@-longcalls}. - -@item --transform | --no-transform -Enable or disable all assembler transformations of Xtensa instructions. -The default is @option{--transform}; -@option{--no-transform} should be used only in the rare cases when the -instructions must be exactly as specified in the assembly source. - -@item --rename-section @var{oldname}=@var{newname} -When generating output sections, rename the @var{oldname} section to -@var{newname}. -@end table +@ifclear man +@xref{Xtensa Options}, for the options available when @value{AS} is configured +for an Xtensa processor. +@end ifclear + +@ifset man +@c man begin OPTIONS +The following options are available when @value{AS} is configured for an +Xtensa processor. +@c man end +@c man begin INCLUDE +@include c-xtensa.texi +@c ended inside the included file @end ifset +@end ifset + +@c man begin OPTIONS + @ifset Z80 The following options are available when @value{AS} is configured for a Z80 family processor. diff --git a/gas/doc/c-xtensa.texi b/gas/doc/c-xtensa.texi index d894b5f..01453df 100644 --- a/gas/doc/c-xtensa.texi +++ b/gas/doc/c-xtensa.texi @@ -3,6 +3,7 @@ @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c +@c man end @ifset GENERIC @page @node Xtensa-Dependent @@ -30,10 +31,9 @@ Reference Manual}. @node Xtensa Options @section Command Line Options -The Xtensa version of the @sc{gnu} assembler supports these -special options: +@c man begin OPTIONS +@table @gcctabopt -@table @code @item --text-section-literals | --no-text-section-literals @kindex --text-section-literals @kindex --no-text-section-literals @@ -94,6 +94,8 @@ Rename the @var{oldname} section to @var{newname}. This option can be used multiple times to rename multiple sections. @end table +@c man end + @node Xtensa Syntax @section Assembler Syntax @cindex syntax, Xtensa assembler -- cgit v1.1