Re: [RFC/PATCH v3] perf report: Show random usage tip on the help line

From: Namhyung Kim
Date: Sat Jan 09 2016 - 04:57:01 EST


On Fri, Jan 08, 2016 at 09:06:35AM +0100, Ingo Molnar wrote:
>
> * Ingo Molnar <mingo@xxxxxxxxxx> wrote:
>
> >
> > * Namhyung Kim <namhyung@xxxxxxxxxx> wrote:
> >
> > > Currently perf report only shows a help message "For a higher level
> > > overview, try: perf report --sort comm,dso" unconditionally (even if
> > > the sort keys were used). Add more help tips and show randomly.
> > >
> > > Load tips from ${prefix}/share/doc/perf-tip/tips.txt file.
> >
> > > +++ b/tools/perf/Documentation/tips.txt
> > > @@ -0,0 +1,14 @@
> > > +For a higher level overview, try: perf report --sort comm,dso
> > > +Group related events with: perf record -e '{cycles,instructions}:S'
> > > +Compare performance results with: perf diff [<old file> <new file>]
> > > +Boolean options have negative forms like: perf report --no-children
> > > +Customize output of perf script with: perf script -F event,ip,sym
> > > +Generate a script for your data: perf script -g <lang>
> > > +Save output of perf stat using: perf stat record
> > > +Create archive of data to see it on other machine: perf archive
> > > +Search options using a keyword: perf report -h <keyword>
> > > +Use parent filter to see specific call path: perf report -p <regex>
>
> We could also include a more basic tip that suggests call graph recording? Most
> people don't know about it I think.

Will add.

Thanks,
Namhyung