Apple restrictions in DYLD_LIBRARY_PATH for RunEnvironment & some typos

Author: danimtb

howtos/manage_shared_libraries/env_vars.rst

@@ -1,3 +1,5 @@
+.. _manage_shared_libraries_env_vars:
+
 Manage Shared Libraries with Environment Variables
 ==================================================
 
@@ -156,7 +158,7 @@ runtime. In Windows, it is enough if the package added its binary folder to the
 
 Security restrictions might apply in OSX
 (`read this thread <https://stackoverflow.com/questions/35568122/why-isnt-dyld-library-path-being-propagated-here>`_), so the
-``DYLD_LIBRARY_PATH`` environment variable is not directly transferred to the child process. In that case, you have to use it explicitely in
+``DYLD_LIBRARY_PATH`` environment variable is not directly transferred to the child process. In that case, you have to use it explicitly in
 your conanfile.py:
 
 .. code-block:: python
@@ -201,7 +203,7 @@ Using the **virtualrunenv** generator
 
 Even if ``toolA`` doesn't declare the variables in the ``package_info`` method, you can use
 the :ref:`virtualrunenv generator<virtual_run_environment_generator>`. It will set automatically
-the environment variables poiting to the "lib" and "bin" folders.
+the environment variables pointing to the "lib" and "bin" folders.
 
 
 **conanfile.txt**
@@ -225,4 +227,3 @@ the environment variables poiting to the "lib" and "bin" folders.
     conan install .
     source activate
     toolA --someparams
-

reference/build_helpers/run_environment.rst

@@ -1,4 +1,3 @@
-
 .. _run_environment_reference:
 
 RunEnvironment
@@ -27,7 +26,7 @@ This helper is specially useful:
             # All the lib folders will be available in LD_LIBRARY_PATH and DYLD_LIBRARY_PATH
 
 
-Set environment variables:
+I sets the following environment variables:
 
 +--------------------+---------------------------------------------------------------------+
 | NAME               | DESCRIPTION                                                         |
@@ -39,5 +38,22 @@ Set environment variables:
 | DYLD_LIBRARY_PATH  | Containing all the requirements ``lib`` folders. (OSX)              |
 +--------------------+---------------------------------------------------------------------+
 
+.. important::
+
+    Security restrictions might apply in OSX
+    (`read this thread <https://stackoverflow.com/questions/35568122/why-isnt-dyld-library-path-being-propagated-here>`_), so the
+    ``DYLD_LIBRARY_PATH`` environment variable is not directly transferred to the child process. In that case, you have to use it explicitly in
+    your *conanfile.py*:
+
+    .. code-block:: python
+
+        def build(self):
+            env_build = RunEnvironment(self)
+            with tools.environment_append(env_build.vars):
+                # self.run('./myexetool") # won't work, even if 'DYLD_LIBRARY_PATH' is in the env
+                self.run('DYLD_LIBRARY_PATH=%s ./myexetool" % os.environ['DYLD_LIBRARY_PATH'])
+
+.. seealso::
 
-.. seealso:: - :ref:`Reference/Tools/environment_append <environment_append_tool>`
+    - :ref:`manage_shared_libraries_env_vars`
+    - :ref:`environment_append_tool`