Hi CMake developers, we wanted to use the link_libraries command and we were scared off by its deprecation. Fortunately someone found Brad's statement [1] about the "deprecated". The use of deprecated is pretty bad as this usually indicates that a feature will be removed in future versions. I understand that the command should be avoided if possible.
I tried to clarify the documentation with the attached patch. It uses Sphinx' note command to emphasis using target_link_libraries. Bye Christoph [1] http://www.cmake.org/pipermail/cmake/2009-April/028439.html -- When you die, that does not mean that you lose to cancer, you beat cancer by how you live, why you live, and in the manner in which you live. -- Stuart Scott, 1965-2015
>From 8f7e32a3955fab434ab6068d33ec0731f313511f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Christoph=20Gr=C3=BCninger?= <[email protected]> Date: Sun, 25 Jan 2015 22:22:03 +0100 Subject: [PATCH] link_libraries.rst: Clarify status of command. Use Sphinx's note to warn about command's shortcoming. "Deprecate" indicated that link_libraries will be removed in future CMake versions which is not the case. --- Help/command/link_libraries.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Help/command/link_libraries.rst b/Help/command/link_libraries.rst index d690c9b..4b37577 100644 --- a/Help/command/link_libraries.rst +++ b/Help/command/link_libraries.rst @@ -1,8 +1,6 @@ link_libraries -------------- -Deprecated. Use the target_link_libraries() command instead. - Link libraries to all targets added later. :: @@ -14,3 +12,7 @@ Specify a list of libraries to be linked into any following targets command is passed down to all subdirectories. The debug and optimized strings may be used to indicate that the next library listed is to be used only for that specific type of build. + +.. note:: + Library dependencies are chained automatically. If possible, use the + target_link_libraries() command instead. -- 2.1.2
-- Powered by www.kitware.com Please keep messages on-topic and check the CMake FAQ at: http://www.cmake.org/Wiki/CMake_FAQ Kitware offers various services to support the CMake community. For more information on each offering, please visit: CMake Support: http://cmake.org/cmake/help/support.html CMake Consulting: http://cmake.org/cmake/help/consulting.html CMake Training Courses: http://cmake.org/cmake/help/training.html Visit other Kitware open-source projects at http://www.kitware.com/opensource/opensource.html Follow this link to subscribe/unsubscribe: http://public.kitware.com/mailman/listinfo/cmake-developers
