pages: updated news entry with info about debian source package devel…

…opment

source/pages/content/news.md

@@ -2,6 +2,24 @@
 
 ---
 
+## 2024-02-28 - Debian Source Packages
+
+This past week I've been diving into the wonderful world of debian packaging. Specifically, constructing a debian source package via CMake which can be used to build the cgosling library from source, and generate both binary and dev packages.
+
+This exercise has been a bit difficult for a few reasons:
+
+- I knew almost nothing about debian source packing at the start of this process.
+- The current debian stable only has rustc version 1.63 in the apt repositories, which means I had to make some changes to remove the rustc 1.66 dependency.
+- An upstream bug in cargo ([rust-lang/cargo#5045 - Support soname for cdylibs](https://github.com/rust-lang/cargo/issues/5045)) meant following the debian documentation results in deb packages with lintian errors.
+
+This last issue proved to be the most time consuming. Essentially, the debian tools used to generate a binary package from a source package depend on the presence of the soname metadata field in the provided elf binaries to trigger a call to ldconfig on package installation. This ldconfig step essentially updates some data-store which tells the runtime linker what runtime libraries are available, as well as their versions. However, the rust toolchain does not set this metadata field for cdylib targets like it should. This resulted in libraries which the debian tools did not realise were libraries
+
+To work around this, I have added a patchelf step which updates this soname field manually for Linux builds. I have also renamed the Linux shared-library target to include full semantic version at the end (libcgosling.so.0.2.1) and added symlinks to this library in the standard format (libcsogling.so and libcgosling.so.0) to play nicely in actual deployments.
+
+As part of this, I have also moved the crate's semantic version definition out of its Cargo.toml file, and instead into the CMake part of the build-system. This way, we can generate all the various files (Cargo.toml, debian/control, debian/rules, etc) which need the semantic and major versions.
+
+With commit [5ae906c](https://github.com/blueprint-freespeech/gosling/commit/5ae906ce8fb7e35de5b6747037f440f9dd49d81f), we are now able to build debian source packages, and end-users can build binary and dev packages. This is the first step in eventually getting cgosling into debian. Hopefully it will be all the easier by having a properly formatted (with no lintian errors!) source package to start from.
+
 ## 2024-02-01 - FOSDEM!
 
 The Blueprint for Free Speech's Gosling and Ricochet Refresh team is going to Brussels to attend one of the world's largest free software events – [FOSDEM 2024](https://fosdem.org/2024/)