From 335b8c63e02ddaea1239e38e92281420e28d6cf5 Mon Sep 17 00:00:00 2001
From: Felix Eckhofer <felix@eckhofer.com>
Date: Sun, 20 Feb 2022 14:04:28 +0100
Subject: [PATCH] Explain file-rename logic

---
 src/documents/signals/handlers.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/documents/signals/handlers.py b/src/documents/signals/handlers.py
index bd046e707..a86ee047f 100644
--- a/src/documents/signals/handlers.py
+++ b/src/documents/signals/handlers.py
@@ -226,6 +226,8 @@ def set_tags(sender,
 def cleanup_document_deletion(sender, instance, using, **kwargs):
     with FileLock(settings.MEDIA_LOCK):
         if settings.TRASH_DIR:
+            # Find a non-conflicting filename in case a document with the same
+            # name was moved to trash earlier
             counter = 0
             old_filename = os.path.split(instance.source_path)[1]
             (old_filebase, old_fileext) = os.path.splitext(old_filename)