Add implementation comments

GuillaumeGomez · Oct 30, 2022 · a4e6255 · a4e6255
1 parent d4b4055
commit a4e6255
Showing 1 changed file with 4 additions and 0 deletions.
diff --git 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),