lkml.org 
[lkml]   [2009]   [Aug]   [6]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    /
    Date
    From
    SubjectRe: perf: "Longum est iter per praecepta, breve et efficax per exempla"

    * Carlos R. Mafra <crmafra2@gmail.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@gmail.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@gmail.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


    \
     
     \ /
      Last update: 2009-08-06 11:13    [W:2.134 / U:0.008 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site