linux-kernel - Re: perf: "Longum est iter per praecepta, breve et efficax per exempla"

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Date:	Thu, 6 Aug 2009 11:10:59 +0200
From:	Ingo Molnar <mingo@...e.hu>
To:	"Carlos R. Mafra" <crmafra2@...il.com>
Cc:	Pekka Enberg <penberg@...helsinki.fi>,
	Peter Zijlstra <a.p.zijlstra@...llo.nl>,
	LKML <linux-kernel@...r.kernel.org>, Valdis.Kletnieks@...edu
Subject: Re: perf: "Longum est iter per praecepta, breve et efficax per
	exempla"


* Carlos R. Mafra <crmafra2@...il.com> wrote:

> Hi Pekka,
> 
> On Thu  6.Aug'09 at 10:08:44 +0300, Pekka Enberg wrote:
> > Hi Carlos,
> > 
> > On Wed, Aug 5, 2009 at 9:53 PM, Carlos R. Mafra<crmafra2@...il.com> wrote:
> > > A few examples of how 'perf' can be used, from an e-mail by
> > > Ingo Molnar http://lkml.org/lkml/2009/8/4/346.
> > >
> > > Signed-off-by: Carlos R. Mafra <crmafra2@...il.com>
> > > ---
> > >
> > > This "patch" is my way of _suggesting_ some "documentation by examples"
> > > of what 'perf' can do to the guys who can really write it :-)
> > 
> > I was also looking for a perf "cookbook" and Ingo suggested we should
> > put this stuff on the kernel.org wiki:
> > 
> > http://perf.wiki.kernel.org/index.php/Main_Page
> > 
> > How about just putting the email there?
> 
> First of all I just would like to rephrase my comment in the 
> patch.
> 
> It was not meant to be a suggestion for Ingo to write more 
> documentation per se, it was my way of pointing out that such 
> "documentation" is useful for beginners and that I, as Valdis, 
> appreciated reading it. So it was more of a "keep coming" and 
> don't rephrain from writing these examples in the e-mails kind of 
> thing.

yeah, that's very useful to newbies, i agree.

I'm not very good at coming up with examples for beginners myself 
(probably partly because i'm already across the learning curve and 
partly because i wrote portions of it so it's 'obvious' to my own 
subjective experience) - so help is welcome.

Another area that could be improved is to make the screen that comes 
up when 'perf' is typed a bit more self-explanatory. Maybe print the 
URL to your "Beginner's Page" wiki page in that place?

Patches are much welcome for that area as well, of course.

> Now about the wiki. Yeah, that sounds great and I didn't know 
> about it yesterday. It will be nice if the wiki becomes a place 
> where people can look for such usage examples.

Thanks,

	Ingo
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/