summaryrefslogtreecommitdiffstats
path: root/specs
diff options
context:
space:
mode:
Diffstat (limited to 'specs')
-rw-r--r--specs/source-package-format-1.0.txt31
1 files changed, 31 insertions, 0 deletions
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.