1 files changed, 9 insertions, 0 deletions
diff --git a/lib/lib_pm.PL b/lib/lib_pm.PL
index 2c9eb6654d..d7786732b7 100644
--- a/lib/lib_pm.PL
+++ b/lib/lib_pm.PL
@@ -171,6 +171,15 @@ can say
 
     @INC = @lib::ORIG_INC;
 
+=head1 CAVEATS
+
+In order to keep lib.pm small and simple, it only works with Unix
+filepaths.  This doesn't mean it only works on Unix, but non-Unix
+users must first translate their file paths to Unix conventions.
+
+    # VMS users wanting to put [.stuff.moo] into 
+    # their @INC would write
+    use lib 'stuff/moo';
 
 =head1 SEE ALSO