lkml.org 
[lkml]   [2001]   [Dec]   [29]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    /
    Date
    From
    SubjectRe: State of the new config & build system
    On Fri, 28 Dec 2001, Linus Torvalds wrote:

    > Having per-function comment blocks, in contrast, makes sense to have
    > inline:
    >
    > - you read the comment when you read the function
    > - you might even update the comment when you update the function
    > - you have a reasonable 1:1 relationship.

    Personally I'd like to see each C file have a header like
    this too, describing in a few lines what the functions in
    this file are supposed to do.

    This should make it easier for people to figure out not just
    what each C file is about, but also if they should spend their
    time wading through this particular C file when in search of
    some piece of code.

    regards,

    Rik
    --
    Shortwave goes a long way: irc.starchat.net #swl

    http://www.surriel.com/ http://distro.conectiva.com/

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

    \
     
     \ /
      Last update: 2005-03-22 13:14    [W:0.029 / U:31.932 seconds]
    ©2003-2016 Jasper Spaans. hosted at Digital OceanAdvertise on this site