Note about editable packages and collect_libs (conan-io#1721)

* note about editable packages * change word * Update developing_packages/editable_packages.rst Co-authored-by: Daniel <[email protected]> * Update developing_packages/editable_packages.rst Co-authored-by: Daniel <[email protected]> Co-authored-by: Daniel <[email protected]>
orgarten · Jun 2, 2020 · ebe2e8d · ebe2e8d
1 parent b712aa7
commit ebe2e8d
Showing 1 changed file with 7 additions and 2 deletions.
diff --git a/developing_packages/editable_packages.rst b/developing_packages/editable_packages.rst
@@ -77,8 +77,13 @@ the ``say`` package, the ``examples/features/editable/cmake/say/lib`` to locate
 
 That might not be very useful, as typically while editing the source code and doing incremental builds, the
 development layout is different from that final "package" layout. While it is possible to run a
-:command:`conan package` local command to execute the packaging in the user folder, and that will achieve that
-final layout, that is not very elegant. Conan provides several ways to customize the layout for editable packages.
+:command:`conan package` local command to execute the packaging in the user folder and it will achieve that
+final layout, that is not very elegant as it should be run after every modification.
+
+In order to populate ``cpp_info.libs``, the usage of ``tools.collect_libs()`` is discouraged as it won't find
+any library when the package is in editable mode and it hasn't been compiled yet. This empty list will be
+written to files by generators and it won't be updated after working on the editable package.
+
 
 Editable packages layouts
 -------------------------