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,FREEMAIL_FROM
	autolearn=unavailable autolearn_force=no version=3.4.4
X-Received: by 10.236.128.72 with SMTP id e48mr5199679yhi.20.1391103793692;
        Thu, 30 Jan 2014 09:43:13 -0800 (PST)
X-Received: by 10.182.3.12 with SMTP id 12mr19599oby.36.1391103793518; Thu, 30
 Jan 2014 09:43:13 -0800 (PST)
Path: 
 eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!news.eternal-september.org!news.eternal-september.org!news.eternal-september.org!feeder.eternal-september.org!feeder.erje.net!eu.feeder.erje.net!news.glorb.com!f11no10614009qae.1!news-out.google.com!vg8ni1igb.0!nntp.google.com!c10no7047393igq.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail
Newsgroups: comp.lang.ada
Date: Thu, 30 Jan 2014 09:43:13 -0800 (PST)
In-Reply-To: <1391099324.30150.70.camel@pascal.home.net>
Complaints-To: groups-abuse@google.com
Injection-Info: glegroupsg2000goo.googlegroups.com;
 posting-host=89.214.185.66;
 posting-account=3cDqWgoAAAAZXc8D3pDqwa77IryJ2nnY
NNTP-Posting-Host: 89.214.185.66
References: <l90ee99ngsun16ec498p60nm3s0ah29r47@4ax.com>
 <lcbc0j$cci$1@online.de>
 <lccket$oo1$1@speranza.aioe.org> <1391099324.30150.70.camel@pascal.home.net>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <f65297c2-092c-44cf-bcb4-0555e9dd0973@googlegroups.com>
Subject: Re: need help learning Ada for a modula-2 programmer
From: Marius Amado-Alves <amado.alves@gmail.com>
Injection-Date: Thu, 30 Jan 2014 17:43:13 +0000
Content-Type: text/plain; charset=ISO-8859-1
Xref: news.eternal-september.org comp.lang.ada:18330
Date: 2014-01-30T09:43:13-08:00
List-Id: <comp.lang.ada>

> Hard to understand why a commonly used and spread usage in all big open
> source projects could be wrong!!!

Argumentum ad populum.

FWIW I think revision *notes* as comments on the source file are often ok and helpful, lacking a truly integrated environment. I often place such notes in the locus of change.

Mind, revision *notes*; not a long changelog/revision history style passage: that looks a bit awkward to me too. Like long headers, might impair readability.

BTW long headers are quite *common* too (e.g. GNAT) but that does not make them a *good* practice.