Allow to control library dependency finder mode from library.json; set ldf_mode to 1 by default

docs/librarymanager/config.rst

@@ -533,6 +533,13 @@ More details :ref:`projectconf_extra_script`.
 Archive object files to Static Library. This is default behavior of PlatformIO
 Build System (``"libArchive": true``).
 
+``libLDFMode``
+~~~~~~~~~~~~~~
+
+*Optional* | Type: ``Integer``
+
+Specify Library Dependency Finder Mode. See :ref:`ldf_mode` for details.
+
 **Examples**
 
 1. Custom macros/defines

docs/librarymanager/ldf.rst

@@ -65,10 +65,10 @@ project (:ref:`projectconf_pio_src_dir`) and can work in the next modes:
 * ``0`` - "manual mode", does not process source files of a project and
   dependencies. Builds only the libraries that are specified in
   manifests (:ref:`library_config`, ``module.json``) or in the :ref:`projectconf`.
-* ``1`` - parses ALL C/C++ source code of the project and follows only by
-  nested includes/chain (``#include ...``) from the libraries.
-* ``2`` - **default** - parses ALL C/C++ source code of the project and parses
-  ALL C/C++ source code of the each dependency (recursively).
+* ``1`` - **default** - parses ALL C/C++ source code of the project and follows
+  only by nested includes (``#include ...``, chain...) from the libraries.
+* ``2`` - parses ALL C/C++ source code of the project and parses
+  ALL C/C++ source code of the each found dependency (recursively).
 
 This mode can be changed using :ref:`projectconf_lib_ldf_mode` option in
 :ref:`projectconf`.

docs/projectconf.rst

@@ -812,13 +812,8 @@ Example:
 .. seealso::
     Please make sure to read :ref:`ldf` guide first.
 
-Library Dependency Finder starts work from analyzing source files of the
-project (:ref:`projectconf_pio_src_dir`) and can work in the different modes
-(see :ref:`ldf_mode`).
-
-By default, this value is set to ``lib_ldf_mode = 2`` and means that LDF
-will parse ALL C/C++ source code of the project and will parse ALL C/C++
-source code of the each dependent library (recursively).
+This option specifies how does Library Dependency Finder should analyze
+dependencies (``#include`` directives). See :ref:`ldf_mode` for details.
 
 .. _projectconf_lib_compat_mode: