elaborate on the editor selection of the programs

(Helmut Grohne) move login and shadowconfig to /usr

See merge request debian/shadow!19

debian/changelog

@@ -1,3 +1,16 @@
+shadow (1:4.13+dfsg1-4.1) unstable; urgency=medium
+
+  * Enhance the manpage for vipw (closes #1064940).
+
+ -- Toni Mueller <toni@debian.org>  Thu, 29 Feb 2024 16:37:32 +0000
+
+shadow (1:4.13+dfsg1-4) unstable; urgency=medium
+
+  [ Helmut Grohne ]
+  * DEP17: Move login and shadowconfig to /usr. (Closes: #1059915)
+
+ -- Serge Hallyn <serge@hallyn.com>  Sun, 04 Feb 2024 20:28:27 +0000
+
 shadow (1:4.13+dfsg1-3) unstable; urgency=medium
 
   * Team upload

debian/login.install

@@ -4,4 +4,4 @@ sbin/nologin usr/sbin
 usr/bin/faillog
 usr/bin/lastlog
 usr/bin/newgrp
-bin/login
+bin/login usr/bin

debian/passwd.install

@@ -1,5 +1,5 @@
 debian/default/useradd etc/default
-debian/shadowconfig sbin
+debian/shadowconfig usr/sbin
 usr/bin/chage
 usr/bin/chfn
 usr/bin/chsh

debian/rules

@@ -42,7 +42,7 @@ endif
 	dh_install -a
 ifeq ($(DEB_HOST_ARCH_OS),hurd)
 	# /bin/login is provided by the hurd package.
-	rm -f debian/login/bin/login
+	rm -f debian/login/usr/bin/login
 endif
 
 override_dh_installpam:

man/vipw.8.xml

@@ -73,10 +73,20 @@
       the appropriate locks to prevent file corruption. When looking for an
       editor, the programs will first try the environment variable
       <envar>$VISUAL</envar>, then the environment variable
-      <envar>$EDITOR</envar>, and finally the default editor,
+      <envar>$EDITOR</envar>, then the editor from
+      <filename>~/.selected_editor</filename>, and finally
+      <command>nano</command>.
       <citerefentry><refentrytitle>vi</refentrytitle>
       <manvolnum>1</manvolnum></citerefentry>.
     </para>
+    <para>
+        On the first run, if the environment variables <envar>$VISUAL</envar>
+        and <envar>$EDITOR</envar> are both unset, this program asks you for
+        an editor and stores your selection in
+        <filename>~/.selected_editor</filename>. If the editor mentioned
+        therein does not exist on your system, the program will fall back
+        to using <command>nano</command>.
+    </para>
   </refsect1>
 
   <refsect1 id='options'>
@@ -210,6 +220,9 @@
       <citerefentry>
 	<refentrytitle>gshadow</refentrytitle><manvolnum>5</manvolnum>
       </citerefentry>
+      <citerefentry>
+          <refentrytitle>~/.selected_editor</refentrytitle><manvolnum>5</manvolnum>
+      </citerefentry>
       <citerefentry condition="tcb">
 	<refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum>
       </citerefentry>,