diff --git a/lib/puppet/parser/functions.rb b/lib/puppet/parser/functions.rb
index <HASH>..<HASH> 100644
--- a/lib/puppet/parser/functions.rb
+++ b/lib/puppet/parser/functions.rb
@@ -162,7 +162,8 @@ module Functions
     type is defined, either as a native type or a defined type, or whether a class is defined.
     This is useful for checking whether a class is defined and only including it if it is.
     This function can also test whether a resource has been defined, using resource references
-    (e.g., ``if defined(File['/tmp/myfile'] { ... }``).") do |vals|
+    (e.g., ``if defined(File['/tmp/myfile'] { ... }``).  This function is unfortunately
+    dependent on the parse order of the configuration when testing whether a resource is defined.") do |vals|
         result = false
         vals.each do |val|
             case val
Applying a version of the diff to the defined() docs from David Schmitt

git-svn-id: <URL>