add example documentation for inotify_wait_modified_delay

and add config to ansible role

ansible/defaults/main.yml

@@ -58,6 +58,7 @@ paperlessng_tika_gotenberg_endpoint: http://localhost:3000
 # Software tweaks
 paperlessng_time_zone: Europe/Berlin
 paperlessng_consumer_polling: 0
+paperlessng_consumer_inotify_wait_modified_delay: 0.1
 paperlessng_consumer_delete_duplicates: False
 paperlessng_consumer_recursive: False
 paperlessng_consumer_subdirs_as_tags: False

ansible/tasks/main.yml

@@ -335,6 +335,8 @@
       line: "PAPERLESS_TIME_ZONE={{ paperlessng_time_zone }}"
     - regexp: PAPERLESS_CONSUMER_POLLING
       line: "PAPERLESS_CONSUMER_POLLING={{ paperlessng_consumer_polling }}"
+    - regexp: PAPERLESS_CONSUMER_INOTIFY_WAIT_MODIFIED_DELAY
+      line: "PAPERLESS_CONSUMER_INOTIFY_WAIT_MODIFIED_DELAY={{ paperlessng_consumer_inotify_wait_modified_delay }}"
     - regexp: PAPERLESS_CONSUMER_DELETE_DUPLICATES
       line: "PAPERLESS_CONSUMER_DELETE_DUPLICATES={{ paperlessng_consumer_delete_duplicates }}"
     - regexp: PAPERLESS_CONSUMER_RECURSIVE

docs/configuration.rst

@@ -533,6 +533,13 @@ PAPERLESS_CONSUMER_POLLING=<num>
 
     Defaults to 0, which disables polling and uses filesystem notifications.
 
+PAPERLESS_CONSUMER_INOTIFY_WAIT_MODIFIED_DELAY=<float>
+		If paperless consumes a file and get a "finished" event with ``inotify``,
+		the file might get picked up by the scanner again to write additional content.
+		Specify a wait delay in seconds here to make paperless wait for changes to the file
+		so that it can continue consuming that same file.
+
+		Defaults to 0.1, waiting for 100 milliseconds.
 
 PAPERLESS_CONSUMER_DELETE_DUPLICATES=<bool>
     When the consumer detects a duplicate document, it will not touch the

paperless.conf.example

@@ -55,6 +55,7 @@
 #PAPERLESS_THREADS_PER_WORKER=1
 #PAPERLESS_TIME_ZONE=UTC
 #PAPERLESS_CONSUMER_POLLING=10
+#PAPERLESS_CONSUMER_INOTIFY_WAIT_MODIFIED_DELAY=0.1
 #PAPERLESS_CONSUMER_DELETE_DUPLICATES=false
 #PAPERLESS_CONSUMER_RECURSIVE=false
 #PAPERLESS_CONSUMER_IGNORE_PATTERNS=[".DS_STORE/*", "._*", ".stfolder/*"]