From da097aa6fcef2d937cf35d5764895fa195090bc5 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Sun, 18 Dec 2016 11:39:05 +0100
Subject: [PATCH] Clarify PATH modification, refs #5970

---
 doc/articles/scripts.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/articles/scripts.md b/doc/articles/scripts.md
index c916ed017..6328b0eab 100644
--- a/doc/articles/scripts.md
+++ b/doc/articles/scripts.md
@@ -210,8 +210,10 @@ simply running `composer test`:
 }
 ```
 
-> **Note:** Composer's bin-dir is pushed on top of the PATH so that binaries
-> of dependencies are easily accessible as CLI commands when writing scripts.
+> **Note:** Before executing scripts, Composer's bin-dir is temporarily pushed
+> on top of the PATH environment variable so that binaries of dependencies
+> are easily accessible. In this example no matter if the `phpunit` binary is
+> actually in `vendor/bin/phpunit` or `bin/phpunit` it will be found and executed.
 
 ## Referencing scripts