From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable autolearn_force=no version=3.4.4 Path: border1.nntp.dca3.giganews.com!backlog4.nntp.dca3.giganews.com!backlog4.nntp.ams3.giganews.com!backlog4.nntp.ams.giganews.com!border2.nntp.ams.giganews.com!nntp.giganews.com!newsfeed.xs4all.nl!newsfeed4.news.xs4all.nl!xs4all!rt.uk.eu.org!eternal-september.org!feeder.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail From: Simon Wright Newsgroups: comp.lang.ada Subject: Re: need help learning Ada for a modula-2 programmer Date: Thu, 30 Jan 2014 18:10:51 +0000 Organization: A noiseless patient Spider Message-ID: References: <1391099324.30150.70.camel@pascal.home.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: mx05.eternal-september.org; posting-host="f4c34a0d1a0b50d7528d4047756bbea8"; logging-data="25112"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1854KbGFtKVMwXSW50wWm+JSJ9SIj7vlvc=" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (darwin) Cancel-Lock: sha1:Y4CnoBn/4efXy7hneDydXXfrAyI= sha1:/4B6C/5ZIONoK3rIohg+dqupToI= X-Original-Bytes: 1752 Xref: number.nntp.dca.giganews.com comp.lang.ada:184612 Date: 2014-01-30T18:10:51+00:00 List-Id: Pascal Obry writes: > And why should a developer have to duplicate information about what > has been done when it is recorded into the VCS? I've been asking myself that. The GCC convention[1] (using SVN or a synchronized git, I don't know which is the master) is to note with each commit the overall purpose and, for each changed file, a summary of the changes. This seems sensible, and I've adopted it for my own projects; it can seem like just regurgitating the source changes, but there's almost always a _why_ to be added. [1] http://www.gnu.org/prep/standards/html_node/Style-of-Change-Logs.html