presets and auto-named modules

content/darkroom/processing-modules/presets.md

@@ -89,7 +89,7 @@ focal length
 format
 : Only apply the preset to certain types of image. Check boxes to include files matching these criteria; uncheck boxes to exclude those files. Choose from "raw", "non-raw", "HDR", "monochrome" and "color".
 
-# managing presets
+## managing presets
 
 Both user-defined and internal presets can be viewed and managed from within [preferences > presets](../../../preferences-settings/presets.md).
 
@@ -101,3 +101,12 @@ If you delete a preset that has the same name as one of the built-in presets, th
 
 ---
 
+## module naming in the darkroom view
+
+By default, if the current parameters of a processing module match those of a saved preset, darktable will attempt to automatically set the name (label) of the module in question, as follows:
+
+- If the user has manually amended the name of the module in the current image, the module name will be left unchanged,
+- If the module instance from which the preset was created had a manually-set name, any subsequent module that matches this preset will automatically be given the same name. Note that if this was unintentional, the only way to revert will be to drop and recreate the preset, since the automatic name is a hidden field in the database,
+- If the module instance from which the preset was created did not have a manually-set name, the name of any subsequent module that matches this preset will be set to the same as the preset name.
+
+This functionality can be disabled in [preferences > darkroom > automatically update module name](../../preferences-settings/darkroom.md#modules).

content/preferences-settings/darkroom.md

@@ -79,3 +79,6 @@ show mask indicator in module headers
 
 prompt for name on addition of new instance
 : If enabled, when creating a new instance of a processing module, a prompt will be immediately displayed allowing you to set a name for the new instance (default off).
+
+automatically update module name
+: Automatically update the name (label) on processing modules if the current parameters of the module match those of a saved [preset](../darkroom/processing-modules/presets.md#module-naming-in-the-darkroom-view). The module name will only be updated if it hasn't already been manually amended for the current image. It will be set either to the module name from which the preset was made (if the module name was manually adjusted before the preset was created) or to the name of the preset itself (default on).