From 3cbb0ba99651f081ce1401604701997f8a0ad453 Mon Sep 17 00:00:00 2001
From: Leif Arne Storset <leifarne@storset.net>
Date: Tue, 11 Dec 2012 21:43:07 +0100
Subject: [PATCH] Clarify global-namespace explanation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

I had trouble understanding this passage, but a peek in the documentation
explained it.  It's not about "execution" – the execution of the function is
unaffected – it's about name resolution. And it's also not really about
"definition".

While I was at it, I renamed "method" to function, as these are not methods and
methods aren't really affected by namespaces (they're already namespaced by a
class). Also copyedited a bit.
---
 pages/The-Basics.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/pages/The-Basics.md b/pages/The-Basics.md
index 092ce58..b905277 100644
--- a/pages/The-Basics.md
+++ b/pages/The-Basics.md
@@ -104,8 +104,8 @@ function test($a)
 
 ## Global namespace
 
-While using namespaces, you may find your code being executed in the wrong scope for internal methods. To fix this,
-define the method globally by using a backslash before the method.
+When using namespaces, you may find that internal functions are hidden by functions you wrote. To fix this,
+refer to the global function by using a backslash before the function name.
 
 {% highlight php %}
 <?php
@@ -113,14 +113,14 @@ namespace phptherightway;
 
 function fopen()
 {
-    $file = \fopen();    // our function name is the same as an internal function
-                         // execute globally by adding '\'.
+    $file = \fopen();    // Our function name is the same as an internal function.
+                         // Execute the function from the global space by adding '\'.
 }
 
 function array()
 {
-    $iterator = new \ArrayIterator();    // ArrayIterator is an internal class. Using it without a backslash
-                                         // will execute it within the namespace scope
+    $iterator = new \ArrayIterator();    // ArrayIterator is an internal class. Using its name without a backslash
+                                         // will attempt to resolve it within your namespace.
 }
 {% endhighlight %}