From ad57cff9bc38a4a97f4ecccc7655e2dfd73fc75c Mon Sep 17 00:00:00 2001
From: Eelco Dolstra <edolstra@gmail.com>
Date: Mon, 24 Apr 2023 13:34:46 +0200
Subject: [PATCH] Document tMisc

Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>
---
 src/libfetchers/input-accessor.hh | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/libfetchers/input-accessor.hh b/src/libfetchers/input-accessor.hh
index 23c510d4d..1cb233c51 100644
--- a/src/libfetchers/input-accessor.hh
+++ b/src/libfetchers/input-accessor.hh
@@ -13,7 +13,17 @@ class Store;
 
 struct InputAccessor
 {
-    enum Type { tRegular, tSymlink, tDirectory, tMisc };
+    enum Type {
+      tRegular, tSymlink, tDirectory,
+      /**
+        Any other node types that may be encountered on the file system, such as device nodes, sockets, named pipe, and possibly even more exotic things.
+
+        Responsible for `"unknown"` from `builtins.readFileType "/dev/null"`.
+
+        Unlike `DT_UNKNOWN`, this must not be used for deferring the lookup of types.
+      */
+      tMisc
+    };
 
     struct Stat
     {