Document mlir_target_link_libraries

Author: nikic

mlir/cmake/modules/AddMLIR.cmake

@@ -718,6 +718,14 @@ function(mlir_check_all_link_libraries name)
   endif()
 endfunction(mlir_check_all_link_libraries)
 
+# Link target against a list of MLIR libraries. If MLIR_LINK_MLIR_DYLIB is
+# enabled, this will link against the MLIR dylib instead of the static
+# libraries.
+#
+# This function should be used instead of target_link_libraries() when linking
+# MLIR libraries that are part of the MLIR dylib. For libraries that are not
+# part of the dylib (like test libraries), target_link_libraries() should be
+# used.
 function(mlir_target_link_libraries target type)
   if (TARGET obj.${target})
     target_link_libraries(obj.${target} ${ARGN})