Added documentation to libdl module

stdlib/Libdl/docs/src/index.md

@@ -2,6 +2,11 @@
 EditURL = "https://github.com/JuliaLang/julia/blob/master/stdlib/Libdl/docs/src/index.md"
 ```
 
+The Libdl module in Julia provides specialized and lower-level facilities for dynamic linking with shared libraries. While Julia
+inherently supports linking to runtime shared libraries through the `ccall intrinsic, `Libdl` extends this capability by offering additional, more
+granular control. It enables users to search for shared libraries both in memory and the filesystem, manually load them with specific runtime linker options, and look up
+library symbols as low-level pointers.
+
 # Dynamic Linker
 
 ```@docs

stdlib/Libdl/src/Libdl.jl

@@ -1,5 +1,10 @@
 # This file is a part of Julia. License is MIT: https://julialang.org/license
-
+"""
+The Libdl module in Julia provides specialized and lower-level facilities for dynamic linking with shared libraries. While Julia
+inherently supports linking to runtime shared libraries through the `ccall intrinsic, `Libdl` extends this capability by offering additional, more
+granular control. It enables users to search for shared libraries both in memory and the filesystem, manually load them with specific runtime linker options, and look up
+library symbols as low-level pointers.
+"""
 module Libdl
 # Just re-export Base.Libc.Libdl:
 export DL_LOAD_PATH, RTLD_DEEPBIND, RTLD_FIRST, RTLD_GLOBAL, RTLD_LAZY, RTLD_LOCAL,

stdlib/Libdl/test/runtests.jl

@@ -331,7 +331,5 @@ end
 end; end
 
 @testset "Docstrings" begin
-    undoc = Docs.undocumented_names(Libdl)
-    @test_broken isempty(undoc)
-    @test undoc == [:Libdl]
+    @test isempty(Docs.undocumented_names(Libdl))
 end