From e8fd2a4cb49c91e5af1608b3cd494e2a8cf02ae2 Mon Sep 17 00:00:00 2001 From: Richard Levitte Date: Sat, 6 Aug 2016 11:30:48 +0200 Subject: [PATCH] Add a note about a perl issue on VMS and how to work around it I bug in perl's File::Spec->canonpath() was uncovered. There's nothing we can do about it (except re-implementing canonpath()), except working around the problem (a directory rename) and reporting the issue to the perl module developers. Reviewed-by: Rich Salz --- INSTALL | 4 ++-- NOTES.VMS | 18 ++++++++++++++++++ 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/INSTALL b/INSTALL index ed7849e7cb..3655eb7b3f 100644 --- a/INSTALL +++ b/INSTALL @@ -15,8 +15,8 @@ header files * a supported operating system - For additional platform specific requirements and other details, - please read one of these: + For additional platform specific requirements, solutions to specific + issues and other details, please read one of these: * NOTES.VMS (OpenVMS) * NOTES.WIN (any supported Windows) diff --git a/NOTES.VMS b/NOTES.VMS index 6aeda11c77..3e9a57e805 100644 --- a/NOTES.VMS +++ b/NOTES.VMS @@ -27,6 +27,24 @@ 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 -----------------