From 221f934de296236f0219f8816fd3598838612693 Mon Sep 17 00:00:00 2001
From: ComplexSpaces <complexspacescode@gmail.com>
Date: Tue, 4 Oct 2022 21:17:46 -0500
Subject: [PATCH] Add implementation comments

---
 src/apple/disk.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/apple/disk.rs b/src/apple/disk.rs
index a1e91b7f0..b5595a1b1 100644
--- a/src/apple/disk.rs
+++ b/src/apple/disk.rs
@@ -126,6 +126,10 @@ pub(super) unsafe fn get_disks() -> Vec<Disk> {
             None => continue,
         };
 
+        // Future note: There is a difference between `kCFURLVolumeIsBrowsableKey` and the
+        // `kCFURLEnumeratorSkipInvisibles` option of `CFURLEnumeratorOptions`. Specifically,
+        // the first one considers the writable `Data`(`/System/Volumes/Data`) partition to be
+        // browsable, while it is classified as "invisible" by CoreFoundation's volume emumerator.
         let browsable = get_bool_value(
             prop_dict.inner(),
             DictKey::Extern(ffi::kCFURLVolumeIsBrowsableKey),