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=ham
	autolearn_force=no version=3.4.4
X-Google-Thread: 103376,254d058bd7de11b3,start
X-Google-Attributes: gid103376,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!news1.google.com!proxad.net!proxad.net!npeer.de.kpn-eurorings.net!news.uni-stuttgart.de!news.belwue.de!LF.net!news.enyo.de!not-for-mail
From: Florian Weimer <fw@deneb.enyo.de>
Newsgroups: comp.lang.ada
Subject: Writing changelog entries
Date: Tue, 04 Jan 2005 21:31:48 +0100
Message-ID: <87y8f96imj.fsf@deneb.enyo.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Trace: albireo.enyo.de 1104870710 25500 212.9.189.171 (4 Jan 2005 20:31:50
 GMT)
X-Complaints-To: 
Cancel-Lock: sha1:hNcef8uzdC5a9zuIvcDSPe9NDzU=
Xref: g2news1.google.com comp.lang.ada:7442
Date: 2005-01-04T21:31:48+01:00
List-Id: <comp.lang.ada>

How are you writing your changelog entries?

There are a few Ada-specific questions.  Shall I include the package
name, or is the file name enough?  How does one deal with homonyms?

Here's an example, but I'm not completely satisfied with it.  Then
again, I don't use changelogs much because I wrote most of the code
pretty recent and it's still a small project (by Ada's standard, not
necessarily by mine).

----------------------------------------------------------------------
r762:  fw | 2005-01-04 21:26:27 +0100

* lib/core/enyo-io.ads, lib/core/enyo-io.adb (Put):
  New procedure which copies data from one buffer to another.

* lib/core/enyo-io-file_queues.ads, lib/core/enyo-io-file_queues.adb
  (Write): Rename to Put.
  (Put): New procedure which copies the contents of a buffer.

* test/tests-io-channels.adb, test/tests-io.adb:
  Adjust old Put calls.

* test/tests-io-file_queues.adb:
  Adjust old Write calls.  New test case for Put of a buffer.