Fix documentation

api/python/src/DyldSharedCache/pyDyldSharedCache.cpp

@@ -225,6 +225,13 @@ void create<dsc::DyldSharedCache>(nb::module_& m) {
         },
         R"doc(
         Convert the given virtual address into an offset.
+
+        .. code-block:: warning
+
+            If the shared cache contains multiple subcaches,
+            this function needs to be called on the targeted subcache.
+            See :func:`~.DyldSharedCache.cache_for_address` to find the
+            associated subcache.
         )doc"_doc, "virtual_address"_a
     )
 

api/rust/cargo/lief/src/dsc/dyld_shared_cache.rs

@@ -309,6 +309,12 @@ impl DyldSharedCache {
     }
 
     /// Convert the given virtual address into an offset.
+    /// <div class="warning">
+    /// If the shared cache contains multiple subcaches,
+    /// this function needs to be called on the targeted subcache.
+    /// </div>
+    ///
+    /// See: [`DyldSharedCache::cache_for_address`]
     pub fn va_to_offset(&self, address: u64) -> Result<u64, Error> {
         to_result!(ffi::dsc_DyldSharedCache::va_to_offset, &self, address);
     }

doc/sphinx/extended/dsc/index.rst

@@ -56,7 +56,7 @@ From this |lief-dsc-dyldsharedcache| object, we can inspect the embedded
 
         dyld_cache: lief.dsc.DylibSharedCache = ...
 
-        for dylib in dyld_cache.libraries():
+        for dylib in dyld_cache.libraries:
             print("0x{:016x}: {}".format(dylib.address, dylib.path))
 
     .. tab:: :fa:`regular fa-file-code` C++

include/LIEF/DyldSharedCache/DyldSharedCache.hpp

@@ -219,6 +219,10 @@ class LIEF_API DyldSharedCache {
   std::unique_ptr<DyldSharedCache> find_subcache(const std::string& filename) const;
 
   /// Convert the given virtual address into an offset.
+  ///
+  /// \warning If the shared cache contains multiple subcaches,
+  ///          this function needs to be called on the targeted subcache.
+  ///          See cache_for_address() to find the associated subcache.
   result<uint64_t> va_to_offset(uint64_t va) const;
 
   /// Return the stream associated with this dyld shared cache