diff --git a/doc/api/path.markdown b/doc/api/path.markdown
index 2541c62d82..df2e46005e 100644
--- a/doc/api/path.markdown
+++ b/doc/api/path.markdown
@@ -25,7 +25,9 @@ Example:
 ## path.join([path1], [path2], [...])
 
 Join all arguments together and normalize the resulting path.
-Non-string arguments are ignored.
+
+Arguments must be strings.  In v0.8, non-string arguments were
+silently ignored.  In v0.10 and up, an exception is thrown.
 
 Example: