perf list: Document missing options

Add the missing options --desc and --debug on the man page.

---
 tools/perf/Documentation/perf-list.txt | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

index 14e13512c05f..1d3fb2846d2d 100644
@@ -18,6 +18,10 @@ various perf commands with the -e option.
 
 OPTIONS
 -------
+-d::
+--desc::
+Print extra event descriptions.
+
 --no-desc::
 Don't print descriptions.
 

@@ -25,11 +29,13 @@ Don't print descriptions.
 --long-desc::
 Print longer event descriptions.
 
+--debug::
+Enable debugging output.
+
 --details::
 Print how named events are resolved internally into perf events, and also
 any extra expressions computed by perf stat.
 
-
 [[EVENT_MODIFIERS]]
 EVENT MODIFIERS
 ---------------

2.17.1

Em Tue, Jul 17, 2018 at 08:07:38PM +0900, Sangwon Hong escreveu:

Please describe how you tested this, i.e. what difference makes using this option you are describing?

I figured it doesn't change anything, since it is the default, so to test if this makes any change one needs to compare the output of:

   perf list --no-desc

with the output of what you just documented, i.e.:

   perf list --desc

comparing what you added with not using any option shows no difference.

Thus we need to add this "(default)" to your patch, to avoid confusion:

+-d::
+--desc::

+Print extra event descriptions. (default)

I'm doing this, please consider adding this to any further work in this area.

- Arnaldo

Em Tue, Jul 17, 2018 at 03:28:52PM -0300, Arnaldo Carvalho de Melo escreveu:

Also please make the summary line more descriptive, I've changed it from:

perf list: Document missing options

To:

perf list: Add missing documentation for --desc and --debug options

So that when one uses:

  git log --oneline

we get this extra bit of info. Also what is missing is the documentation for the options, not the options :-)

- Arnaldo