Flip the default value of --auto and --show-percs to yes.

In both `cg_annotate` and `callgrind_annotate`.

Author: nnethercote

NEWS

@@ -35,7 +35,14 @@ support for X86/macOS 10.13, AMD64/macOS 10.13 and nanoMIPS/Linux.
 
 * Cachegrind:
 
+  - cg_annotate's --auto and --show-percs options now default to 'yes', because
+    they are usually wanted.
+
 * Callgrind:
+
+  - callgrind_annotate's --auto and --show-percs options now default to 'yes',
+    because they are usually wanted.
+
   - The command option --collect-systime has been enhanced to specify
     the unit used to record the elapsed time spent during system calls.
     The command option now accepts the values no|yes|msec|usec|nsec,

cachegrind/cg_annotate.in

@@ -123,11 +123,11 @@ my $default_threshold = 0.1;
 my $single_threshold  = $default_threshold;
 
 # If on, show a percentage for each non-zero count.
-my $show_percs = 0;
+my $show_percs = 1;
 
 # If on, automatically annotates all files that are involved in getting over
 # all the threshold counts.
-my $auto_annotate = 0;
+my $auto_annotate = 1;
 
 # Number of lines to show around each annotated line.
 my $context = 8;
@@ -152,9 +152,9 @@ usage: cg_annotate [options] cachegrind-out-file [source-files...]
     --sort=A,B,C          sort columns by events A,B,C [event column order]
     --threshold=<0--20>   a function is shown if it accounts for more than x% of
                           the counts of the primary sort event [$default_threshold]
-    --show-percs=yes|no   show a percentage for each non-zero count
+    --show-percs=yes|no   show a percentage for each non-zero count [yes]
     --auto=yes|no         annotate all source files containing functions
-                          that helped reach the event count threshold [no]
+                          that helped reach the event count threshold [yes]
     --context=N           print N lines of context before and after
                           annotated lines [8]
     -I<d> --include=<d>   add <d> to list of directories to search for 

cachegrind/docs/cg-manual.xml

@@ -368,16 +368,16 @@ and from libraries (e.g. <filename>getc.c</filename>)</para>
 <sect2 id="cg-manual.line-by-line" xreflabel="Line-by-line Counts">
 <title>Line-by-line Counts</title>
 
-<para>There are two ways to annotate source files -- by specifying them
-manually as arguments to cg_annotate, or with the
-<option>--auto=yes</option> option.  For example, the output from running
-<filename>cg_annotate &lt;filename&gt; concord.c</filename> for our example
-produces the same output as above followed by an annotated version of
-<filename>concord.c</filename>, a section of which looks like:</para>
+<para>By default, all source code annotation is also shown. (Filenames to be
+annotated can also by specified manually as arguments to cg_annotate, but this
+is rarely needed.) For example, the output from running <filename>cg_annotate
+&lt;filename&gt; </filename> for our example produces the same output as above
+followed by an annotated version of <filename>concord.c</filename>, a section
+of which looks like:</para>
 
 <programlisting><![CDATA[
 --------------------------------------------------------------------------------
--- User-annotated source: concord.c
+-- Auto-annotated source: concord.c
 --------------------------------------------------------------------------------
 Ir        I1mr ILmr Dr      D1mr  DLmr  Dw      D1mw   DLmw
 
@@ -437,7 +437,7 @@ part of a file the shown code comes from, eg:</para>
 controlled by the <option>--context</option>
 option.</para>
 
-<para>To get automatic annotation, use the <option>--auto=yes</option> option.
+<para>Automatic annotation is enabled by default.
 cg_annotate will automatically annotate every source file it can
 find that is mentioned in the function-by-function summary.
 Therefore, the files chosen for auto-annotation are affected by
@@ -946,7 +946,7 @@ small differences like these;  it works in the same way as
 
   <varlistentry>
     <term>
-      <option><![CDATA[--show-percs=<no|yes> [default: no] ]]></option>
+      <option><![CDATA[--show-percs=<no|yes> [default: yes] ]]></option>
     </term>
     <listitem>
       <para>When enabled, a percentage is printed next to all event counts.
@@ -957,7 +957,7 @@ small differences like these;  it works in the same way as
 
   <varlistentry>
     <term>
-      <option><![CDATA[--auto=<no|yes> [default: no] ]]></option>
+      <option><![CDATA[--auto=<no|yes> [default: yes] ]]></option>
     </term>
     <listitem>
       <para>When enabled, automatically annotates every file that

cachegrind/tests/ann1.vgtest

@@ -2,5 +2,5 @@
 # the post-processing of the cgout-test file.
 prog: ../../tests/true
 vgopts: --cachegrind-out-file=cachegrind.out
-post: perl ../../cachegrind/cg_annotate --show=Ir,I1mr,ILmr --auto=yes cgout-test
+post: perl ../../cachegrind/cg_annotate --show=Ir,I1mr,ILmr --show-percs=no cgout-test
 cleanup: rm cachegrind.out

cachegrind/tests/ann2.vgtest

@@ -2,5 +2,5 @@
 # the post-processing of the cgout-test file.
 prog: ../../tests/true
 vgopts: --cachegrind-out-file=cachegrind.out
-post: perl ../../cachegrind/cg_annotate --sort=Dr --show=Dw,Dr,Ir --auto=yes --show-percs=yes cgout-test
+post: perl ../../cachegrind/cg_annotate --sort=Dr --show=Dw,Dr,Ir --auto=yes cgout-test
 cleanup: rm cachegrind.out

callgrind/callgrind_annotate.in

@@ -139,11 +139,11 @@ my $default_threshold = 99;
 my $single_threshold  = $default_threshold;
 
 # If on, show a percentage for each non-zero count.
-my $show_percs = 0;
+my $show_percs = 1;
 
 # If on, automatically annotates all files that are involved in getting over
 # all the threshold counts.
-my $auto_annotate = 0;
+my $auto_annotate = 1;
 
 # Number of lines to show around each annotated line.
 my $context = 8;
@@ -211,9 +211,9 @@ usage: callgrind_annotate [options] [callgrind-out-file [source-files...]]
                           Each event can optionally be followed by a :
                           and a threshold percentage. If some event specific
                           threshold are given, --threshold value is ignored.
-    --show-percs=yes|no   show a percentage for each non-zero count
+    --show-percs=yes|no   show a percentage for each non-zero count [yes]
     --auto=yes|no         annotate all source files containing functions
-                          that helped reach the event count threshold [no]
+                          that helped reach the event count threshold [yes]
     --context=N           print N lines of context before and after
                           annotated lines [8]
     --inclusive=yes|no    add subroutine costs to functions calls [no]

callgrind/docs/cl-manual.xml

@@ -156,7 +156,7 @@ has to rely on heuristics to detect calls and returns.</para>
      </listitem>
   </itemizedlist>
 
-  <para>Use <option>--auto=yes</option> to get annotated source code
+  <para>By default, you will also get annotated source code
   for all relevant functions for which the source can be found. In
   addition to source annotation as produced by
   <computeroutput>cg_annotate</computeroutput>, you will see the
@@ -1307,7 +1307,7 @@ their arguments.</para>
 
   <varlistentry>
     <term>
-      <option><![CDATA[--auto=<yes|no> [default: no] ]]></option>
+      <option><![CDATA[--auto=<yes|no> [default: yes] ]]></option>
     </term>
     <listitem>
       <para>Annotate all source files containing functions that helped 

callgrind/tests/ann1.vgtest

@@ -2,5 +2,5 @@
 # the post-processing of the cgout-test file.
 prog: ../../tests/true
 vgopts: --callgrind-out-file=callgrind.out
-post: perl ../../callgrind/callgrind_annotate --show=Ir,I1mr,ILmr --auto=yes --include=../../cachegrind/tests ../../cachegrind/tests/cgout-test
+post: perl ../../callgrind/callgrind_annotate --show=Ir,I1mr,ILmr --show-percs=no --include=../../cachegrind/tests ../../cachegrind/tests/cgout-test
 cleanup: rm callgrind.out

callgrind/tests/ann2.vgtest

@@ -2,5 +2,5 @@
 # the post-processing of the cgout-test file.
 prog: ../../tests/true
 vgopts: --callgrind-out-file=callgrind.out
-post: perl ../../callgrind/callgrind_annotate --sort=Dr --show=Dw,Dr,Ir --auto=yes --include=../../cachegrind/tests --show-percs=yes ../../cachegrind/tests/cgout-test
+post: perl ../../callgrind/callgrind_annotate --sort=Dr --show=Dw,Dr,Ir --auto=yes --include=../../cachegrind/tests ../../cachegrind/tests/cgout-test
 cleanup: rm callgrind.out