passwd_file: Document variable iteration usage

Author: cmouse

data/updates.js

@@ -58,6 +58,7 @@ export const updates = {
 	migration_imapc_features: '2.4.0',
 	namespace_prefix_shared_variables_changed: '2.4.0',
 	pbkdf2_hashing: '2.4.0',
+	passwd_file_iteration: '2.4.0',
 	process_title_imap_process: '2.4.0',
 	process_title_initializing: '2.4.0',
 	process_title_mail_processes: '2.4.0',

docs/core/config/auth/databases/passwd_file.md

@@ -64,6 +64,11 @@ passdb passwd-file {
 }
 ```
 
+[[added,passwd_file_iteration]]
+
+To iterate databases that use variable expansion in the path, you need to provide enough information when using
+[[doveadm,user]] to iterate. Example [[doveadm,user,*@domain.com]] would match with ``%{user | domain}`` expansion.
+
 ### Variables
 
 [[setting,passdb_fields]] and [[setting,userdb_fields]] can use