;;;; In that case I would suggest putting it on top of the file more
or less like this
;;;; with a lot of ;'s at the start. You could create a script to
update that automatically
;;;; from the CVS I suppose, and if you make sure it's autogenerated
and that it comes
;;;; from the CVS it gives a lot more insight for both sides. But
that's my opinion.
;;;; At least I wouldn't put it in the docstring.
(ns code-starts-here ...)
2011/8/4 octopusgrabbus <octopusgrab...@gmail.com>:
> We have a fairly simple development environment here, not that it
> couldn't stand updating, but other than a consultant, I am the only
> developer. I need changes written directly into each file. and here is
> why.
>
> When I got here over seven years ago, there were well over 200 4GL
> modules and a smattering of C modules built into Informix's customized
> runner for 4GL pcode. Almost no module had comments; and almost no
> module had module header information. We also had no formal build.
>
> Yes, I could look things up in CVS, but I find it better to have stuff
> written in the header.
>
> I'm using $Log$, and it works.
>
> Thanks.
>
> On Aug 3, 5:36 pm, Sean Corfield <seancorfi...@gmail.com> wrote:
>> I think Joop meant to use the change history in your version control system
>> directly, rather than try to put it into the source code.
>>
>> I think the prevailing best practices these days are to _not_ duplicate
>> change history into source code, even thru VCS keyword substitution. The
>> change history is available in the VCS already and also in your IDE, so
>> anyone who needs to know how a given file has changed can go look that up.
>>
>> Sean
>>
>> On Wed, Aug 3, 2011 at 12:29 PM, octopusgrabbus
>> <octopusgrab...@gmail.com>wrote:
>>
>>
>>
>>
>>
>>
>>
>> > Is there a preferred method for adding a Change History block to a
>> > Clojure module? I'm doing this for now:
>>
>> > (ns addr-verify
>> > ^{:author "Charles M. Norton",
>> > :doc "addr-verify is a small Clojure program that runs address
>> > verification through ...
>>
>> > Created on August 3, 2011
>> > Change History: "}
>> > (:gen-class)
>
> --
> You received this message because you are subscribed to the Google
> Groups "Clojure" group.
> To post to this group, send email to clojure@googlegroups.com
> Note that posts from new members are moderated - please be patient with your
> first post.
> To unsubscribe from this group, send email to
> clojure+unsubscr...@googlegroups.com
> For more options, visit this group at
> http://groups.google.com/group/clojure?hl=en
--
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
