* powerpc gas doc
@ 2011-02-10 12:01 Alan Modra
2011-02-10 12:29 ` Alan Modra
2011-02-10 19:08 ` Ralf Wildenhues
0 siblings, 2 replies; 4+ messages in thread
From: Alan Modra @ 2011-02-10 12:01 UTC (permalink / raw)
To: binutils
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
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: powerpc gas doc
2011-02-10 12:01 powerpc gas doc Alan Modra
@ 2011-02-10 12:29 ` Alan Modra
2011-02-10 19:08 ` Ralf Wildenhues
1 sibling, 0 replies; 4+ messages in thread
From: Alan Modra @ 2011-02-10 12:29 UTC (permalink / raw)
To: binutils
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
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: powerpc gas doc
2011-02-10 12:01 powerpc gas doc Alan Modra
2011-02-10 12:29 ` Alan Modra
@ 2011-02-10 19:08 ` Ralf Wildenhues
2011-02-10 22:49 ` Alan Modra
1 sibling, 1 reply; 4+ messages in thread
From: Ralf Wildenhues @ 2011-02-10 19:08 UTC (permalink / raw)
To: binutils
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
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: powerpc gas doc
2011-02-10 19:08 ` Ralf Wildenhues
@ 2011-02-10 22:49 ` Alan Modra
0 siblings, 0 replies; 4+ messages in thread
From: Alan Modra @ 2011-02-10 22:49 UTC (permalink / raw)
To: Ralf Wildenhues; +Cc: binutils
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
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2011-02-10 22:49 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2011-02-10 12:01 powerpc gas doc Alan Modra
2011-02-10 12:29 ` Alan Modra
2011-02-10 19:08 ` Ralf Wildenhues
2011-02-10 22:49 ` Alan Modra
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).