>>>>> "Dave" == Dave Thomas <Dave / PragmaticProgrammer.com> writes:

    Dave> In the 90% complete things I'm writing (it's been 90% complete for
    Dave> months) you'd write

    Dave> #
    Dave> # A class all about books
    Dave> #
    Dave> # Author:  Jason Voegele
    Dave> # Version: 1.0
    Dave> #

    Dave> class ...

I really like this.  It is lightweight and non-intrusive.  I find many
doc systems tend to obscure the source code in favor of making the
docs easy to generate.  This and the Wiki formatting suggested later
in this thread sound good to me.

-- 
-- Jim Weirich     jweirich / one.net    http://w3.one.net/~jweirich
---------------------------------------------------------------------
"Beware of bugs in the above code; I have only proved it correct, 
not tried it." -- Donald Knuth (in a memo to Peter van Emde Boas)