From d43d293fb6bd2899a44534f83ad83aa4386344ff Mon Sep 17 00:00:00 2001
From: Adrien Ferrand <ferrand.ad@gmail.com>
Date: Wed, 15 May 2019 23:54:57 +0200
Subject: [PATCH] Improve comment

---
 certbot/compat/filesystem.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/certbot/compat/filesystem.py b/certbot/compat/filesystem.py
index 0ce010f70..00837f22a 100644
--- a/certbot/compat/filesystem.py
+++ b/certbot/compat/filesystem.py
@@ -20,6 +20,11 @@ def chmod(file_path, mode):
         * for Linux, the POSIX mode will be directly applied using chmod,
         * for Windows, the POSIX mode will be translated into a Windows DACL that make sense for
           Certbot context, and applied to the file using kernel calls.
+
+    The definition of the Windows DACL that correspond to a POSIX mode, in the context of Certbot,
+    is explained at https://github.com/certbot/certbot/issues/6356 and is implemented by the
+    method _generate_windows_flags().
+
     :param str file_path: Path of the file
     :param int mode: POSIX mode to apply
     """