From 73d7064fc7b86bbc33d6ddedcf644c355f94bfe4 Mon Sep 17 00:00:00 2001 From: Drew Bednar Date: Thu, 26 Jun 2025 14:33:55 -0400 Subject: [PATCH] Adds changelog --- docs/PACKAGING.md | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/docs/PACKAGING.md b/docs/PACKAGING.md index e6b58e8..9d561db 100644 --- a/docs/PACKAGING.md +++ b/docs/PACKAGING.md @@ -65,7 +65,7 @@ package-name (version) distribution(s); urgency=level -- Maintainer Name Day, dd Mon yyyy hh:mm:ss +zzzz ``` -The `devscripts` package installed earlier can assist in automating the change log changes, and ensure that they correctly formatted. +The `devscripts` package installed earlier has the `dch`(debchange) tool that can assist in automating the change log changes, and ensure that they correctly formatted. ## Debian Versioning Scheme @@ -103,6 +103,34 @@ Now create a `control` file under the `DEBIAN/` directory touch ./dist/foo_0.1.0-1/DEBIAN/control ``` +``` +Package: foo +Version: 0.1.0-1 +Architecture: amd64 +Maintainer: Your Name +Description: foo - A Go Application +``` + +Now create a `changelog` file under the `DEBIAN/` directory. + +```bash +touch ./dist/foo_0.1.0-1/DEBIAN/changelog +``` + +We will use the debchange tool `dch` to create the first entry in our file. Use `man dch` to learn more about all the options available to you for editing these entries. + +``` +dch --changelog ./dist/foo_0.1.0-1/DEBIAN/changelog --create +``` + +Since we did not set envvars for things like our package or maintainer email you will see warnings. Press enter to continue and you will drop into an text editor with a basic template. + +``` + +``` + +Change the contents of this entry as needed. + ``` ``` \ No newline at end of file