Hi Sandra,
On 14/12/17 17:09, Sandra Loosemore wrote:
On 12/14/2017 08:53 AM, Kyrill Tkachov wrote:
Hi all,
This patch adds an -mverbose-cost-dump option, similar to the one in
aarch64.
It makes the RTX cost dump print the RTX we're costing in the
backend, as well as its cost.
This can be distracting in other cost-related RTL dumps like combine's.
So now we don't dump the backend information by default, but provide
the power-user option -mverbose-cost-dump
to enable the old verbose dumping.
This option is for GCC developers debugging the compiler only, so no
documentation are added.
No, it doesn't work that way. There is a section in invoke.texi "GCC
Developer Options" that is specifically for options that are only
interesting to GCC developers debugging the compiler. Please document
this new option there.
-Sandra
Thanks for pointing me to this. I had assumed that we only want
to document target-independent options as I didn't see any other
target-dependent options in that section, but you are right.
There is no reason from a readers perspective not to document the
target-specific ones as well.
This patch adds a target-specific developer options subsection and adds
a short entry for the aarch64 and arm ones that I'm aware of.
make pdf works fine for me and the resulting pdf looks reasonable to my
eyes.
That said, I'm not very familiar with the texi directives and I'm not
sure what
the argument to the @table directive means. I've used @gcctabopt as I've
seen it used
in other @table directives. Please let me know if I should use something
else.
Ok for trunk?
Thanks,
Kyrill
2017-12-14 Kyrylo Tkachov <kyrylo.tkac...@arm.com>
* doc/invoke.texi (GCC Developer options): Add Target-specific
developer options subsection. Populate it with AArch64 and ARM
options.
commit 34622cad273e03df44d2aaabc5e4bb664af50862
Author: Kyrylo Tkachov <kyrylo.tkac...@arm.com>
Date: Thu Dec 14 17:44:22 2017 +0000
[doc] Add target-specific developer options subsection
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 0d565b4..00de74c 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -14223,6 +14223,24 @@ Print the compiler's built-in specs---and don't do anything else. (This
is used when GCC itself is being built.) @xref{Spec Files}.
@end table
+@subsection Target-specific developer options
+Some targets define additional debug options that are documented here.
+@subsubsection AArch64 developer options
+@table @gcctabopt
+@item -mverbose-cost-dump
+Enable verbose cost model dumping in the debug dump files.
+@item -moverride=
+Override CPU optimization parameters.
+@end table
+
+@subsubsection ARM developer options
+@table @gcctabopt
+@item -mverbose-cost-dump
+Enable verbose cost model dumping in the debug dump files.
+@item -mflip-thumb
+Switch ARM/Thumb modes on alternating functions.
+@end table
+
@node Submodel Options
@section Machine-Dependent Options
@cindex submodel options
