powerpc gas doc

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

powerpc gas doc

Alan Modra-3
I've been meaning to do this for a long time, but hey, who needs
documentation anyway?  :)

        * config/tc-ppc.c (md_show_usage): Remove -l and -b.  Add -K PIC.
        * doc/as.texinfo: Refer to and include c-ppc.texi for PowerPC options.
        (Overview <Target PowerPC options>): Add a number of missing options.
        * doc/c-ppc.texi: Likewise.  Add markup for use in manpage generation.

Index: gas/config/tc-ppc.c
===================================================================
RCS file: /cvs/src/src/gas/config/tc-ppc.c,v
retrieving revision 1.175
diff -u -p -r1.175 tc-ppc.c
--- gas/config/tc-ppc.c 4 Nov 2010 03:30:05 -0000 1.175
+++ gas/config/tc-ppc.c 10 Feb 2011 11:31:14 -0000
@@ -1244,12 +1244,13 @@ PowerPC options:\n\
 -mrelocatable           support for GCC's -mrelocatble option\n\
 -mrelocatable-lib       support for GCC's -mrelocatble-lib option\n\
 -memb                   set PPC_EMB bit in ELF flags\n\
--mlittle, -mlittle-endian, -l, -le\n\
+-mlittle, -mlittle-endian, -le\n\
                         generate code for a little endian machine\n\
--mbig, -mbig-endian, -b, -be\n\
+-mbig, -mbig-endian, -be\n\
                         generate code for a big endian machine\n\
 -msolaris               generate code for Solaris\n\
 -mno-solaris            do not generate code for Solaris\n\
+-K PIC                  set EF_PPC_RELOCATABLE_LIB in ELF flags\n\
 -V                      print assembler version number\n\
 -Qy, -Qn                ignored\n"));
 #endif
Index: gas/doc/as.texinfo
===================================================================
RCS file: /cvs/src/src/gas/doc/as.texinfo,v
retrieving revision 1.232
diff -u -p -r1.232 as.texinfo
--- gas/doc/as.texinfo 3 Feb 2011 23:20:26 -0000 1.232
+++ gas/doc/as.texinfo 10 Feb 2011 11:31:19 -0000
@@ -428,13 +428,18 @@ gcc(1), ld(1), and the Info entries for
 @ifset PPC
 
 @emph{Target PowerPC options:}
-   [@b{-mpwrx}|@b{-mpwr2}|@b{-mpwr}|@b{-m601}|@b{-mppc}|@b{-mppc32}|@b{-m603}|@b{-m604}|
-    @b{-m403}|@b{-m405}|@b{-mppc64}|@b{-m620}|@b{-mppc64bridge}|@b{-mbooke}]
-   [@b{-mcom}|@b{-many}|@b{-maltivec}|@b{-mvsx}] [@b{-memb}]
+   [@b{-a32}|@b{-a64}]
+   [@b{-mpwrx}|@b{-mpwr2}|@b{-mpwr}|@b{-m601}|@b{-mppc}|@b{-mppc32}|@b{-m603}|@b{-m604}|@b{-m403}|@b{-m405}|
+    @b{-m440}|@b{-m464}|@b{-m476}|@b{-m7400}|@b{-m7410}|@b{-m7450}|@b{-m7455}|@b{-m750cl}|@b{-mppc64}|
+    @b{-m620}|@b{-me500}|@b{-e500x2}|@b{-me500mc}|@b{-me500mc64}|@b{-mppc64bridge}|@b{-mbooke}|
+    @b{-mpower4}|@b{-mpr4}|@b{-mpower5}|@b{-mpwr5}|@b{-mpwr5x}|@b{-mpower6}|@b{-mpwr6}|
+    @b{-mpower7}|@b{-mpw7}|@b{-ma2}|@b{-mcell}|@b{-mspe}|@b{-mtitan}|@b{-me300}|@b{-mcom}]
+   [@b{-many}] [@b{-maltivec}|@b{-mvsx}]
    [@b{-mregnames}|@b{-mno-regnames}]
-   [@b{-mrelocatable}|@b{-mrelocatable-lib}]
-   [@b{-mlittle}|@b{-mlittle-endian}|@b{-mbig}|@b{-mbig-endian}]
+   [@b{-mrelocatable}|@b{-mrelocatable-lib}|@b{-K PIC}] [@b{-memb}]
+   [@b{-mlittle}|@b{-mlittle-endian}|@b{-le}|@b{-mbig}|@b{-mbig-endian}|@b{-be}]
    [@b{-msolaris}|@b{-mno-solaris}]
+   [@b{-nops=@var{count}}]
 @end ifset
 @ifset RX
 
@@ -1283,6 +1288,25 @@ Assemble for a little endian target.
 See the info pages for documentation of the MMIX-specific options.
 @end ifset
 
+@ifset PPC
+
+@ifclear man
+@xref{PowerPC-Opts}, for the options available when @value{AS} is configured
+for a PowerPC processor.
+@end ifclear
+
+@ifset man
+@c man begin OPTIONS
+The following options are available when @value{AS} is configured for a
+PowerPC processor.
+@c man end
+@c man begin INCLUDE
+@include c-ppc.texi
+@c ended inside the included file
+@end ifset
+
+@end ifset
+
 @ifset RX
 See the info pages for documentation of the RX-specific options.
 @end ifset
Index: gas/doc/c-ppc.texi
===================================================================
RCS file: /cvs/src/src/gas/doc/c-ppc.texi,v
retrieving revision 1.20
diff -u -p -r1.20 c-ppc.texi
--- gas/doc/c-ppc.texi 18 Jan 2011 13:37:39 -0000 1.20
+++ gas/doc/c-ppc.texi 10 Feb 2011 11:31:19 -0000
@@ -2,6 +2,7 @@
 @c Free Software Foundation, Inc.
 @c This is part of the GAS manual.
 @c For copying conditions, see the file as.texinfo.
+@c man end
 @ifset GENERIC
 @page
 @node PPC-Dependent
@@ -34,7 +35,17 @@ reference manual.
 
 The following table lists all available PowerPC options.
 
-@table @code
+@c man begin OPTIONS
+@table @gcctabopt
+@item -a32
+Generate ELF32 or XCOFF32.
+
+@item -a64
+Generate ELF64 or XCOFF64.
+
+@item -K PIC
+Set EF_PPC_RELOCATABLE_LIB in ELF flags.
+
 @item -mpwrx | -mpwr2
 Generate code for POWER/2 (RIOS2).
 
@@ -53,6 +64,9 @@ Generate code for PowerPC 403/405.
 @item -m440
 Generate code for PowerPC 440.  BookE and some 405 instructions.
 
+@item -m464
+Generate code for PowerPC 464.
+
 @item -m476
 Generate code for PowerPC 476.
 
@@ -68,6 +82,12 @@ Generate code for PowerPC 620/625/630.
 @item -me500, -me500x2
 Generate code for Motorola e500 core complex.
 
+@item -me500mc
+Generate code for Freescale e500mc core complex.
+
+@item -me500mc64
+Generate code for Freescale e500mc64 core complex.
+
 @item -mspe
 Generate code for Motorola SPE instructions.
 
@@ -92,16 +112,16 @@ Generate code for processors with AltiVe
 @item -mvsx
 Generate code for processors with Vector-Scalar (VSX) instructions.
 
-@item -mpower4
+@item -mpower4, -mpwr4
 Generate code for Power4 architecture.
 
-@item -mpower5
+@item -mpower5, -mpwr5, -mpwr5x
 Generate code for Power5 architecture.
 
-@item -mpower6
+@item -mpower6, -mpwr6
 Generate code for Power6 architecture.
 
-@item -mpower7
+@item -mpower7, -mpwr7
 Generate code for Power7 architecture.
 
 @item -mcell
@@ -128,10 +148,10 @@ Support for GCC's -mrelocatable-lib opti
 @item -memb
 Set PPC_EMB bit in ELF flags.
 
-@item -mlittle, -mlittle-endian
+@item -mlittle, -mlittle-endian, -le
 Generate code for a little endian machine.
 
-@item -mbig, -mbig-endian
+@item -mbig, -mbig-endian, -be
 Generate code for a big endian machine.
 
 @item -msolaris
@@ -139,7 +159,11 @@ Generate code for Solaris.
 
 @item -mno-solaris
 Do not generate code for Solaris.
+
+@item -nops=@var{count}
+When aligning, more than @var{count} nops uses a branch.
 @end table
+@c man end
 
 
 @node PowerPC-Pseudo

--
Alan Modra
Australia Development Lab, IBM
Reply | Threaded
Open this post in threaded view
|

Re: powerpc gas doc

Alan Modra-3
On Thu, Feb 10, 2011 at 10:30:56PM +1030, Alan Modra wrote:
> * doc/as.texinfo: Refer to and include c-ppc.texi for PowerPC options.

That wasn't quite correct.  I missed two pieces of markup that meant
some target options following the powerpc ones disappeared.  Blackfin
had the same problem.

        * doc/as.texinfo: Add missing markup around Blackfin and PowerPC
        options.

Index: gas/doc/as.texinfo
===================================================================
RCS file: /cvs/src/src/gas/doc/as.texinfo,v
retrieving revision 1.233
diff -u -p -r1.233 as.texinfo
--- gas/doc/as.texinfo 10 Feb 2011 11:59:12 -0000 1.233
+++ gas/doc/as.texinfo 10 Feb 2011 12:24:03 -0000
@@ -771,6 +771,7 @@ ARM code in mind.
 Specify that PIC code has been generated.
 @end table
 @end ifset
+@c man end
 
 @ifset Blackfin
 
@@ -791,6 +792,7 @@ the Blackfin processor family.
 
 @end ifset
 
+@c man begin OPTIONS
 @ifset CRIS
 See the info pages for documentation of the CRIS-specific options.
 @end ifset
@@ -1288,6 +1290,7 @@ Assemble for a little endian target.
 See the info pages for documentation of the MMIX-specific options.
 @end ifset
 
+@c man end
 @ifset PPC
 
 @ifclear man
@@ -1307,6 +1310,7 @@ PowerPC processor.
 
 @end ifset
 
+@c man begin OPTIONS
 @ifset RX
 See the info pages for documentation of the RX-specific options.
 @end ifset

--
Alan Modra
Australia Development Lab, IBM
Reply | Threaded
Open this post in threaded view
|

Re: powerpc gas doc

Ralf Wildenhues
In reply to this post by Alan Modra-3
Hi Alan,

* Alan Modra wrote on Thu, Feb 10, 2011 at 01:00:56PM CET:
> * config/tc-ppc.c (md_show_usage): Remove -l and -b.  Add -K PIC.
> * doc/as.texinfo: Refer to and include c-ppc.texi for PowerPC options.
> (Overview <Target PowerPC options>): Add a number of missing options.
> * doc/c-ppc.texi: Likewise.  Add markup for use in manpage generation.

> --- gas/doc/c-ppc.texi 18 Jan 2011 13:37:39 -0000 1.20
> +++ gas/doc/c-ppc.texi 10 Feb 2011 11:31:19 -0000

> @@ -139,7 +159,11 @@ Generate code for Solaris.
>  
>  @item -mno-solaris
>  Do not generate code for Solaris.
> +
> +@item -nops=@var{count}
> +When aligning, more than @var{count} nops uses a branch.

Do you mean this?
   When aligning more than @var{count} nops, use a branch.

Comma placement matters for understanding this sentence.

>  @end table
> +@c man end

Thanks, documentation is always appreciated by users!
Ralf
Reply | Threaded
Open this post in threaded view
|

Re: powerpc gas doc

Alan Modra-3
On Thu, Feb 10, 2011 at 08:08:24PM +0100, Ralf Wildenhues wrote:
> Do you mean this?
>    When aligning more than @var{count} nops, use a branch.

No, I meant this.

        * doc/c-ppc.texi (PowerPC-Opts <-nops>): Clarify.

Index: gas/doc/c-ppc.texi
===================================================================
RCS file: /cvs/src/src/gas/doc/c-ppc.texi,v
retrieving revision 1.21
diff -u -p -r1.21 c-ppc.texi
--- gas/doc/c-ppc.texi 10 Feb 2011 11:59:12 -0000 1.21
+++ gas/doc/c-ppc.texi 10 Feb 2011 22:44:28 -0000
@@ -161,7 +161,8 @@ Generate code for Solaris.
 Do not generate code for Solaris.
 
 @item -nops=@var{count}
-When aligning, more than @var{count} nops uses a branch.
+If an alignment directive inserts more than @var{count} nops, put a
+branch at the beginning to skip execution of the nops.
 @end table
 @c man end
 
--
Alan Modra
Australia Development Lab, IBM