Male C. Pig a.k.a. Svinopolist (piggymouse) wrote,
Male C. Pig a.k.a. Svinopolist
piggymouse

[quote,programming,aktuell] K5 on leaked Windows sources

From "We Are Morons: a quick look at the Win2k source":

Despite the above, the quality of the code is generally excellent. Modules are small, and procedures generally fit on a single screen. The commenting is very detailed about intentions, but doesn't fall into "add one to i" redundancy.

There is some variety in the commenting style. Sometimes blocks use // at every line, sometimes the /* */ style. In some modules functions have a history, some do not. Some functions describe their variables in a comment block, some don't. Microsoft appears not to have fallen into the trap of enforcing over-rigid standards or universal use of over-complicated automatic tools. They seem to trust their developers to comment well, and they do.

Subscribe

  • Here take my picture

    Elegy V: His Picture by Dr John Donne Here take my picture; though I bid farewell Thine, in my heart, where my soul dwells, shall dwell. ’Tis…

  • Pea Brush

    Pea Brush by Robert Frost I walked down alone Sunday after church To the place where John has been cutting trees To see for myself about the…

  • Two poems by e.e.cummings

    Summer Silence Eruptive lightnings flutter to and fro Above the heights of immemorial hills; Thirst-stricken air, dumb-throated, in its woe Limply…

  • Post a new comment

    Error

    Anonymous comments are disabled in this journal

    default userpic

    Your IP address will be recorded 

  • 5 comments