Add implementation comments

GuillaumeGomez · Oct 23, 2022 · 817ccc2 · 817ccc2
1 parent 6251d7c
commit 817ccc2
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/src/apple/disk.rs b/src/apple/disk.rs
@@ -130,6 +130,10 @@ unsafe fn get_disk_inner() -> 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),