Make usage messages given by -h and man pages consistent for the scripts.

git-svn-id: svn://svn.valgrind.org/valgrind/trunk@10756

diff --git a/cachegrind/cg_annotate.in b/cachegrind/cg_annotate.in
index 83f348310c465aa9c73ee4dfb8ecd15c41c3183b..29d94264ebf66c56d11b6a24299088976385323e 100644 (file)
--- a/cachegrind/cg_annotate.in
+++ b/cachegrind/cg_annotate.in
@@ -142,7 +142,7 @@ my $version = "@VERSION@";
 
 # Usage message.
 my $usage = <<END
-usage: cg_annotate [options] output-file [source-files]
+usage: cg_annotate [options] cachegrind-out-file [source-files...]
 
   options for the user, with defaults in [ ], are:
     -h --help             show this message

diff --git a/cachegrind/docs/cg_annotate-manpage.xml b/cachegrind/docs/cg_annotate-manpage.xml
index a8178897c4e03a395444301e9cc8c439bb9146e7..095207182fc4ba8ecb6ce35fe7c35ab205fb9ef7 100644 (file)
--- a/cachegrind/docs/cg_annotate-manpage.xml
+++ b/cachegrind/docs/cg_annotate-manpage.xml
@@ -21,7 +21,8 @@
 <cmdsynopsis>
   <command>cg_annotate</command>
   <arg><replaceable>options</replaceable></arg>
-  <arg>filename</arg>
+  <arg choice="plain"><replaceable>cachegrind-out-file</replaceable></arg>
+  <arg choice="opt" rep="repeat"><replaceable>source-files</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
 

diff --git a/callgrind/callgrind_annotate.in b/callgrind/callgrind_annotate.in
index 60ecde0babd8020e3f73a7497b6fb779810c2dc0..5f7393dcd82103099fce82899838074918ebda43 100644 (file)
--- a/callgrind/callgrind_annotate.in
+++ b/callgrind/callgrind_annotate.in
@@ -196,7 +196,7 @@ my $version = "@VERSION@";
 
 # Usage message.
 my $usage = <<END
-usage: callgrind_annotate [options] [data-file [source-files]]
+usage: callgrind_annotate [options] [callgrind-out-file [source-files...]]
 
   options for the user, with defaults in [ ], are:
     -h --help             show this message

diff --git a/callgrind/callgrind_control.in b/callgrind/callgrind_control.in
index 74df0317c0f8a2ab8abe9f108d460899ee27920b..7cb7b3501c9248affd37db6fda31c73675e3d02f 100644 (file)
--- a/callgrind/callgrind_control.in
+++ b/callgrind/callgrind_control.in
@@ -84,7 +84,7 @@ sub shortHelp {
 sub printHelp {
   printHeader;
 
-  print "Usage: callgrind_control [options] [<pid>|<name> ...]\n\n";
+  print "Usage: callgrind_control [options] [pid|program-name...]\n\n";
   print "If no pids/names are given, an action is applied to all currently\n";
   print "active Callgrind runs. Default action is printing short information.\n\n";
   print "Options:\n";

diff --git a/callgrind/docs/callgrind_annotate-manpage.xml b/callgrind/docs/callgrind_annotate-manpage.xml
index a1d8aa8dec1b5b88b64044c348c7a643adc1b4be..2d0482b1ab3aaeee9ddbecf11d6d3f94f0413744 100644 (file)
--- a/callgrind/docs/callgrind_annotate-manpage.xml
+++ b/callgrind/docs/callgrind_annotate-manpage.xml
@@ -21,7 +21,9 @@
   <cmdsynopsis>
     <command>callgrind_annotate</command>    
     <arg choice="opt"><replaceable>options</replaceable></arg>
-    <arg choice="opt"><replaceable>source-files</replaceable></arg>
+    <!-- note the deliberate <arg> nesting here -->
+    <arg choice="opt"><replaceable>callgrind-out-file</replaceable>
+    <arg choice="opt" rep="repeat"><replaceable>source-files</replaceable></arg></arg>
   </cmdsynopsis>
 </refsynopsisdiv>
 

diff --git a/callgrind/docs/callgrind_control-manpage.xml b/callgrind/docs/callgrind_control-manpage.xml
index dd71af0afb87282783e1ebb6db0499e39b8b13a6..952a1c0c130b394857e9e0ecbe1ed81182e25934 100644 (file)
--- a/callgrind/docs/callgrind_control-manpage.xml
+++ b/callgrind/docs/callgrind_control-manpage.xml
@@ -20,7 +20,7 @@
   <cmdsynopsis>
     <command>callgrind_control</command>    
     <arg choice="opt"><replaceable>options</replaceable></arg>
-    <arg choice="opt" rep="repeat"><replaceable>pid/program-name</replaceable></arg>
+    <arg choice="opt" rep="repeat"><replaceable>pid|program-name</replaceable></arg>
   </cmdsynopsis>
 </refsynopsisdiv>
 

diff --git a/massif/docs/ms_print-manpage.xml b/massif/docs/ms_print-manpage.xml
index 835d49bcfbc5e358c624ad5d7a71c4a1d892e036..cd1f4a061c2c3a4df9d3c95c12efb43ce1d2eda5 100644 (file)
--- a/massif/docs/ms_print-manpage.xml
+++ b/massif/docs/ms_print-manpage.xml
@@ -10,6 +10,7 @@
   <refentrytitle>ms_print</refentrytitle>
   <manvolnum>1</manvolnum>
   <refmiscinfo>Release &rel-version;</refmiscinfo>
+  <date>rel-date</date>
 </refmeta>
 
 <refnamediv>
@@ -21,7 +22,7 @@
 <cmdsynopsis>
   <command>ms_print</command>
   <arg><replaceable>options</replaceable></arg>
-  <arg>filename</arg>
+  <arg choice="plain"><replaceable>massif-out-file</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
 

diff --git a/massif/ms_print.in b/massif/ms_print.in
index 2b2a4123958e2048b06e11f5d402a5e1b2c43be2..e6ffdbff8d6f171ad45af7f5baed1f0f51056b62 100755 (executable)
--- a/massif/ms_print.in
+++ b/massif/ms_print.in
@@ -62,7 +62,7 @@ my $ms_print_args;
 
 # Usage message.
 my $usage = <<END
-usage: ms_print [options] <file>
+usage: ms_print [options] massif-out-file
 
   options for the user, with defaults in [ ], are:
     -h --help             show this message