From ea0d945b800e10ab5f0642ff84e86a8aeee4b705 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pjm@nac.net>
Date: Fri, 24 Feb 2012 18:48:20 -0500
Subject: Document source package change log format.

---
(limited to 'specs')

diff --git a/specs/source-package-format-1.0.txt b/specs/source-package-format-1.0.txt
index 2e1fa04..3fa28dd 100644
--- a/specs/source-package-format-1.0.txt
+++ b/specs/source-package-format-1.0.txt
@@ -153,3 +153,34 @@ The fields in the source package metadata are:
     origin source code and documentation and/or information.  Though the
     information in this field is machine-usable, the URL must not be surrounded
     by angle brackets or any other characters.
+
+
+Change Log Format
+=================
+
+Changes made to the source package should be explained in the file 'changelog'.
+
+Each new package revision must be documented with an entry of the following format:
+    package (version)
+    [zero or more blank lines]
+      * change details
+    [zero or more blank lines]
+      * more change details
+        more detailed change details
+    [zero or more blank lines]
+     -- maintainer  date
+
+"package" is the source package name.
+
+"version" is the source package version number.
+
+"maintainer" is the name and e-mail address of the package maintainer.  This
+field must follow the syntax of the "mailbox" symbol of RFC 5322 section 3.4.
+
+"date" is the date of packaging.  This field must follow the syntax of the
+"date-time" symbol of RFC 5322 section 3.3.
+
+It is recommended that single blank lines be used:
+  * After the package name and version and before change entries,
+  * After change entries and before the maintainer and date, and
+  * Between groups of related change entries.
--
cgit v0.9.1