diff --git a/Source/NSPathUtilities.m b/Source/NSPathUtilities.m
index 33484c634..a2d13f09e 100644
--- a/Source/NSPathUtilities.m
+++ b/Source/NSPathUtilities.m
@@ -1544,7 +1544,11 @@ NSHomeDirectory(void)
 }
 
 /**
- * Returns loginName's home directory as an NSString object.
+ * Returns loginName's home directory as an NSString object.<br />
+ * On most systems this returns the directory specified in the system's
+ * password file, but on ms-windows this is determined by examining the
+ * HOMEPATH and HOMEDRIVE environment variables or (if those don't make
+ * sense) the USERPROFILE environment variable.
  */
 /* NOTE FOR DEVELOPERS.
  * If you change the behavior of this method you must also change