Source: debianutils
Version: 5.7-0.3
Tags: patch
X-Debbugs-Cc: Axel Beckert <a...@debian.org>

Axel Beckert made me aware that while we added update-shells to
debianutils, I failed to document it in the canonical place. I'm
attaching a patch to improve that situation

Helmut
diff --minimal -Nru debianutils-5.7/debian/README.shells 
debianutils-5.7/debian/README.shells
--- debianutils-5.7/debian/README.shells        2022-05-01 18:43:27.000000000 
+0200
+++ debianutils-5.7/debian/README.shells        2022-11-03 06:17:43.000000000 
+0100
@@ -4,10 +4,17 @@
 meant to be used as login shells.
 
 /etc/shells is no longer a config file, but is maintained by the
-add-shell and remove-shell programs.  So, if a package contains
-something that the maintainer thinks ought to be a valid login shell,
-it's postinst should, (on initial install only, to allow a sysadmin to
-take it out again), run:
+add-shell, remove-shell and update-shells programs.  So, if a
+package contains something that the maintainer thinks ought to be a
+valid login shell, it can have its shell included in two different way.
+
+By placing a fragment in /usr/share/debianutils/shells.d/<binarypackage>,
+it will invoke a file trigger on debian-utils and invoke update-shells,
+which will add and remove the contained shells from /etc/shells as
+needed.
+
+Alternatively, it's postinst should, (on initial install only, to allow a
+sysadmin to take it out again), run:
 
 /usr/sbin/add-shell /path/to/shell
 
@@ -15,5 +22,6 @@
 
 /usr/sbin/remove-shell /path/to/shell
 
-As the various shells start to use it, the default shells list will
-shrink.
+The latter method has the disadvantage of shells disappearing from /etc/shells
+when the relevant package is removed but not purged and then reinstalled. The
+fragment method does not suffer from this limitation.
diff --minimal -Nru debianutils-5.7/debian/changelog 
debianutils-5.7/debian/changelog
--- debianutils-5.7/debian/changelog    2022-07-27 08:20:06.000000000 +0200
+++ debianutils-5.7/debian/changelog    2022-11-03 06:17:48.000000000 +0100
@@ -1,3 +1,10 @@
+debianutils (5.7-0.4) UNRELEASED; urgency=medium
+
+  * Non-maintainer upload.
+  * Update /etc/shells micropolicy to recommend declarative use. (Closes: #-1)
+
+ -- Helmut Grohne <hel...@subdivi.de>  Thu, 03 Nov 2022 06:17:48 +0100
+
 debianutils (5.7-0.3) unstable; urgency=medium
 
   * Non-maintainer upload.

Reply via email to