[users] Document retirement of 'nonempty'

CHANGES-3.3

@@ -12,12 +12,17 @@ the history of the 3.2 series (2018-05 - 2022-08).
 
 This release contains contributions from (alphabetically by first name):
  - Adriaan de Groot
+ - Alberto Salvia Novella
  - Christophe Marin
  - Frede Hundewadt
 
 ## Core ##
 
 ## Modules ##
+ - *users* and *usersq* no longer support the password requirement 'nonempty'.
+   Use 'minLength: 1' instead. The example configuration allows the user to
+   choose any password at all, but also contains suggestions for other
+   password-requirements schemes. (thanks Alberto)
 
 
 # 3.3.0-alpha6 (2023-11-16)

src/modules/users/Config.cpp

@@ -834,19 +834,9 @@ addPasswordCheck( const QString& key, const QVariant& value, PasswordCheckList&
     }
     else if ( key == "nonempty" )
     {
-        if ( value.toBool() )
+        cWarning() << "nonempty check is ignored; use minLength: 1";
-        {
-            passwordChecks.push_back(
-                PasswordCheck( []() { return QCoreApplication::translate( "PWQ", "Password is empty" ); },
-                               []( const QString& s ) { return !s.isEmpty(); },
-                               PasswordCheck::Weight( 1 ) ) );
-        }
-        else
-        {
-            cDebug() << "nonempty check is mentioned but set to false";
         return false;
     }
-    }
 #ifdef CHECK_PWQUALITY
     else if ( key == "libpwquality" )
     {

src/modules/users/users.schema.yaml

@@ -41,7 +41,6 @@ properties:
         additionalProperties: false
         type: object
         properties:
-            nonempty: { type: boolean, default: true }
             minLength: { type: number }
             maxLength: { type: number }
             libpwquality: { type: array, items: { type: string } }  # Don't know what libpwquality supports

src/modules/usersq/usersq.conf

@@ -27,9 +27,8 @@ setRootPassword: true
 doReusePassword: true
 
 passwordRequirements:
-    nonempty: true
+    minLength: -1
-    minLength: -1  # Password at least this many characters
+    maxLength: -1
-    maxLength: -1  # Password at most this many characters
     libpwquality:
         - minlen=0
         - minclass=0