README.source: Add tasks for separately-packaged built-in libraries
authorSean Whitton <spwhitton@spwhitton.name>
Wed, 26 Feb 2025 08:08:10 +0000 (16:08 +0800)
committerSean Whitton <spwhitton@spwhitton.name>
Wed, 26 Feb 2025 08:08:10 +0000 (16:08 +0800)
debian/README.source

index fc24668561580d9518f751f94632505ceb0b303b..38f6c4721e6bcb2c2e9fbf7aa37fc27cc6d977a1 100644 (file)
@@ -163,6 +163,29 @@ have both src:emacs and src:emacs-non-dfsg in the same repository.
     % git push --follow-tags debian BRANCH # for each branch updated
     % rm -rf ~/tmp/emacs/
 
+After uploading a new major version
+===================================
+
+Some built-in libraries are also packaged separately in Debian.
+The list is maintained in the source code of the function
+dhelpa-filter-deps-for-debian in the dh-elpa source package.
+
+If there are any libraries that are newly included as built-in in a new
+major release just uploaded, these must be added to that list.
+For example, eglot appeared as a separate package in Debian before a
+copy was included in the upload of Emacs 29.1.
+From that upload onwards, eglot should appear in the list.
+
+In addition, as explained in the docstring for
+dhelpa-filter-deps-for-debian, we must ensure that all built-in
+libraries packaged separately are at versions at least as new as the
+ones shipped in the newly-uploaded major release of Emacs.
+
+The occasion of a new major release is a good opportunity to review
+whether some of these separately-packaged should no longer have their
+own packages.
+E.g. <https://lists.debian.org/debian-emacsen/2025/02/msg00147.html>.
+
 Credits
 =======
 
@@ -170,4 +193,4 @@ The repository layout, DFSG splitting and this workflow were developed mostly
 by Rob Browning.  Sean Whitton updated the workflow in a few respects, adding
 the use of worktrees, and prepared and published this documentation.
 
- -- Sean Whitton <spwhitton@spwhitton.name>, Mon, 24 Feb 2025 16:23:28 +0800
+ -- Sean Whitton <spwhitton@spwhitton.name>, Wed, 26 Feb 2025 16:07:26 +0800