diff --git a/README.md b/README.md
index 63b06b4..0c8fb8e 100644
--- a/README.md
+++ b/README.md
@@ -168,6 +168,10 @@ require("oil").setup({
     is_hidden_file = function(name, bufnr)
       return vim.startswith(name, ".")
     end,
+    -- This function defines what will never be shown, even when `show_hidden` is set
+    is_always_hidden = function(name, bufnr)
+      return false
+    end,
   },
   -- Configuration for the floating window in oil.open_float
   float = {
diff --git a/doc/oil.txt b/doc/oil.txt
index 22c4fc0..8b94607 100644
--- a/doc/oil.txt
+++ b/doc/oil.txt
@@ -73,6 +73,10 @@ OPTIONS                                                              *oil-option
         is_hidden_file = function(name, bufnr)
           return vim.startswith(name, ".")
         end,
+        -- This function defines what will never be shown, even when `show_hidden` is set
+        is_always_hidden = function(name, bufnr)
+          return false
+        end,
       },
       -- Configuration for the floating window in oil.open_float
       float = {