X-Git-Url: https://git.openssl.org/?p=openssl.git;a=blobdiff_plain;f=NOTES.VMS;h=3e9a57e8052b60455c9ad400797dcec0e4f2ed16;hp=034ecf4c6bb4593f5fbcf303a8ddc3fcc944567d;hb=c13d2a5be720a8ab8f0cb67fc2750ed27eee3d9e;hpb=b54e35f6cd9a9de3962daa0112e33bd178c49f6d

diff --git a/NOTES.VMS b/NOTES.VMS
index 034ecf4c6b..3e9a57e805 100644
--- a/NOTES.VMS
+++ b/NOTES.VMS
@@ -15,11 +15,34 @@
  About ANSI C compiler
  ---------------------
 
- An ANSI C compiled is needed among other things.  This means that VAX C
- is not and will not be supported.
+ An ANSI C compiled is needed among other things.  This means that
+ VAX C is not and will not be supported.
 
- We have only tested with DEC C (a.k.a HP VMS C / VSI C), compiling with
- a different ANSI C compiler may require some work.
+ We have only tested with DEC C (a.k.a HP VMS C / VSI C) and require
+ version 7.1 or later.  Compiling with a different ANSI C compiler may
+ require some work.
+
+ Please avoid using C RTL feature logical names DECC$* when building
+ and testing OpenSSL.  Most of all, they can be disruptive when
+ running the tests, as they affect the Perl interpreter.
+
+
+ About ODS-5 directory names and Perl
+ ------------------------------------
+
+ It seems that the perl function canonpath() in the File::Spec module
+ doesn't treat file specifications where the last directory name
+ contains periods very well.  Unfortunately, some versions of VMS tar
+ will keep the periods in the OpenSSL source directory instead of
+ converting them to underscore, thereby leaving your source in
+ something like [.openssl-1^.1^.0].  This will lead to issues when
+ configuring and building OpenSSL.
+
+ We have no replacement for Perl's canonpath(), so the best workaround
+ for now is to rename the OpenSSL source directory, as follows (please
+ adjust for the actual source directory name you have):
+
+    $ rename openssl-1^.1^.0.DIR openssl-1_1_0.DIR 
 
 
  About MMS and DCL