Add docs for lib bindings with supported library versions

src/big/lib_gmp.cr

@@ -1,3 +1,9 @@
+# Supported library versions:
+#
+# * libgmp
+# * libmpir
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#big-numbers
 {% if flag?(:win32) %}
   @[Link("mpir")]
 {% else %}

src/compiler/crystal/ffi/lib_ffi.cr

@@ -1,3 +1,8 @@
+# Supported library versions:
+#
+# * libffi
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#compiler-dependencies
 module Crystal
   @[Link("ffi")]
   {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}

src/crystal/lib_iconv.cr

@@ -4,6 +4,11 @@ require "c/stddef"
   {% raise "The `without_iconv` flag is preventing you to use the LibIconv module" %}
 {% end %}
 
+# Supported library versions:
+#
+# * libiconv-gnu
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#big-numbers
 @[Link("iconv")]
 {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}
   @[Link(dll: "libiconv.dll")]

src/crystal/system/unix/lib_event2.cr

@@ -7,6 +7,11 @@ require "c/netdb"
   @[Link("rt")]
 {% end %}
 
+# Supported library versions:
+#
+# * libevent2
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#other-runtime-libraries
 {% if flag?(:openbsd) %}
   @[Link("event_core")]
   @[Link("event_extra")]

src/gc/boehm.cr

@@ -32,6 +32,11 @@ require "crystal/tracing"
   @[Link("gc", pkg_config: "bdw-gc")]
 {% end %}
 
+# Supported library versions:
+#
+# * libgc (8.2.0+; earlier versions require a patch for MT support)
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#other-runtime-libraries
 {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}
   @[Link(dll: "gc.dll")]
 {% end %}

src/lib_c.cr

@@ -1,3 +1,14 @@
+# Supported library versions:
+#
+# * glibc (2.26+)
+# * musl libc (1.2+)
+# * system libraries of several BSDs
+# * macOS system library (11+)
+# * MSVCRT
+# * WASI
+# * bionic libc
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#system-library
 {% if flag?(:win32) %}
   @[Link({{ flag?(:static) ? "libucrt" : "ucrt" }})]
 {% end %}

src/lib_z/lib_z.cr

@@ -1,3 +1,8 @@
+# Supported library versions:
+#
+# * zlib
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#other-stdlib-libraries
 @[Link("z")]
 {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}
   @[Link(dll: "zlib1.dll")]

src/llvm/lib_llvm.cr

@@ -40,6 +40,11 @@
   end
 {% end %}
 
+# Supported library versions:
+#
+# * LLVM (8-18; aarch64 requires 12+)
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#other-stdlib-libraries
 {% begin %}
   lib LibLLVM
     IS_180 = {{LibLLVM::VERSION.starts_with?("18.0")}}

src/openssl/lib_crypto.cr

@@ -1,3 +1,9 @@
+# Supported library versions:
+#
+# * openssl (1.1.0+)
+# * libressl
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#tls
 {% begin %}
   lib LibCrypto
     {% if flag?(:win32) %}

src/openssl/lib_ssl.cr

@@ -4,6 +4,12 @@ require "./lib_crypto"
   {% raise "The `without_openssl` flag is preventing you to use the LibSSL module" %}
 {% end %}
 
+# Supported library versions:
+#
+# * openssl (1.1.0+)
+# * libressl
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#tls
 {% begin %}
   lib LibSSL
     {% if flag?(:win32) %}

src/regex/lib_pcre.cr

@@ -1,3 +1,8 @@
+# Supported library versions:
+#
+# * libpcre
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#regular-expression-engine
 @[Link("pcre", pkg_config: "libpcre")]
 {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}
   @[Link(dll: "pcre.dll")]

src/regex/lib_pcre2.cr

@@ -1,3 +1,8 @@
+# Supported library versions:
+#
+# * libpcre2 (recommended: 10.36+)
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#regular-expression-engine
 @[Link("pcre2-8", pkg_config: "libpcre2-8")]
 {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}
   @[Link(dll: "pcre2-8.dll")]

src/xml/libxml2.cr

@@ -4,6 +4,11 @@ require "./parser_options"
 require "./html_parser_options"
 require "./save_options"
 
+# Supported library versions:
+#
+# * libxml2
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#other-stdlib-libraries
 @[Link("xml2", pkg_config: "libxml-2.0")]
 {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}
   @[Link(dll: "libxml2.dll")]

src/yaml/lib_yaml.cr

@@ -1,5 +1,10 @@
 require "./enums"
 
+# Supported library versions:
+#
+# * libyaml
+#
+# See https://crystal-lang.org/reference/man/required_libraries.html#other-stdlib-libraries
 @[Link("yaml", pkg_config: "yaml-0.1")]
 {% if compare_versions(Crystal::VERSION, "1.11.0-dev") >= 0 %}
   @[Link(dll: "yaml.dll")]