[users] Document change to config, document TODO:3.3

CHANGES-3.2

@@ -17,7 +17,9 @@ This release contains contributions from (alphabetically by first name):
  - No core changes yet
 
 ## Modules ##
- - No module changes yet
+ - *users* module has rearranged configuration for setting the hostname.
+   Legacy settings are preserved, but produce a warning. Please see
+   `users.conf` for details.
 
 
 # 3.2.54 (2022-03-21) #

src/modules/users/Config.cpp

@@ -826,6 +826,7 @@ either( T ( *f )( const QVariantMap&, const QString&, U ),
     }
 }
 
+// TODO:3.3: Remove
 static void
 copyLegacy( const QVariantMap& source, const QString& sourceKey, QVariantMap& target, const QString& targetKey )
 {
@@ -860,6 +861,7 @@ Config::setConfigurationMap( const QVariantMap& configurationMap )
         bool ok = false;  // Ignored
         QVariantMap hostnameSettings = CalamaresUtils::getSubMap( configurationMap, "hostname", ok );
 
+        // TODO:3.3: Remove calls to copyLegacy
         copyLegacy( configurationMap, "setHostname", hostnameSettings, "location" );
         copyLegacy( configurationMap, "writeHostsFile", hostnameSettings, "writeHostsFile" );
         m_hostNameActions = getHostNameActions( hostnameSettings );

src/modules/users/users.conf

@@ -171,10 +171,14 @@ hostname:
   location: EtcFile
   writeHostsFile: true
 
+# TODO:3.3: Remove this setting
+#
 # This is a legacy setting for hostname.location; if it is set
 # at all, and there is no setting for hostname.location, it is used.
 setHostname: EtcFile
 
+# TODO:3.3: Remove this setting
+#
 # This is a legacy setting for hostname.writeHostsFile
 writeHostsFile: true