Update docs

Author: AFMiziara

examples/build_file_generation/BUILD.bazel

@@ -28,6 +28,9 @@ modules_mapping(
         "^_|(\\._)+",  # This is the default.
         "(\\.tests)+",  # Add a custom one to get rid of the psutil tests.
     ],
+    # Uncomment the next line to enable hermetic builds across platforms
+    # by ignoring platform-specific native libraries (useful for opencv-python-headless, etc.)
+    # ignore_native_libs = True,
     wheels = all_whl_requirements,
 )
 

gazelle/docs/installation_and_usage.md

@@ -96,6 +96,14 @@ modules_mapping(
     # for tools like type checkers and IDEs, improving the development experience and
     # reducing manual overhead in managing separate stub packages.
     include_stub_packages = True,
+
+    # ignore_native_libs: bool (default: False)
+    # If set to True, this flag ignores platform-specific native libraries (.so files)
+    # when generating the modules mapping. This ensures hermetic builds across different
+    # platforms (Linux, macOS, etc.) by producing identical manifests regardless of
+    # platform-specific wheel contents. Useful for packages like opencv-python-headless
+    # that include different native libraries on different platforms.
+    # ignore_native_libs = True,
 )
 
 # Gazelle python extension needs a manifest file mapping from

gazelle/modules_mapping/def.bzl

@@ -68,7 +68,10 @@ modules_mapping = rule(
         ),
         "ignore_native_libs": attr.bool(
             default = False,
-            doc = "Whether to ignore native libraries (*.so files) for platform-independent mappings.",
+            doc = "Whether to ignore platform-specific native libraries (*.so files) when generating mappings. " +
+                  "When True, ensures hermetic builds across different platforms by excluding native library " +
+                  "mappings that vary between Linux, macOS, etc. Useful for packages like opencv-python-headless " +
+                  "that bundle different native libraries on different platforms.",
             mandatory = False,
         ),
         "modules_mapping_name": attr.string(