[Xtensa Gas Patch] Use new man page feature

[Xtensa Gas Patch] Use new man page feature

[Sterling Augustine]

[-- Attachment #1: Type: text/plain, Size: 418 bytes --]

I have committed the following patch which follows the several others in 
using the new "document gas target-specific options in only one place" 
feature.

Sterling

2010-11-23  Sterling Augustine  <sterling@tensilica.com>

	* 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.


[-- Attachment #2: xtensa-docs.patch --]
[-- Type: text/plain, Size: 4583 bytes --]

Index: gas/doc/as.texinfo
===================================================================
RCS file: /cvs/src/src/gas/doc/as.texinfo,v
retrieving revision 1.227
diff -u -p -d -u -r1.227 as.texinfo
--- gas/doc/as.texinfo	23 Nov 2010 15:27:36 -0000	1.227
+++ gas/doc/as.texinfo	23 Nov 2010 19:17:22 -0000
@@ -480,6 +480,15 @@ gcc(1), ld(1), and the Info entries for 
    [@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 
 @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}.
+@ifclear man
+@xref{Xtensa Options}, for the options available when @value{AS} is configured
+for an Xtensa processor.
+@end ifclear
 
-@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.
+@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
 
-@item --rename-section @var{oldname}=@var{newname}
-When generating output sections, rename the @var{oldname} section to
-@var{newname}.
-@end table
 @end ifset
 
+@c man begin OPTIONS
+
 @ifset Z80
 The following options are available when @value{AS} is configured for
 a Z80 family processor.
Index: gas/doc/c-xtensa.texi
===================================================================
RCS file: /cvs/src/src/gas/doc/c-xtensa.texi,v
retrieving revision 1.14
diff -u -p -d -u -r1.14 c-xtensa.texi
--- gas/doc/c-xtensa.texi	2 Sep 2009 07:24:21 -0000	1.14
+++ gas/doc/c-xtensa.texi	23 Nov 2010 19:17:28 -0000
@@ -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
 multiple times to rename multiple sections.
 @end table
 
+@c man end
+
 @node Xtensa Syntax
 @section Assembler Syntax
 @cindex syntax, Xtensa assembler