From b52f3fcbb1c0ef575b52e41a2baec4a2542b96da Mon Sep 17 00:00:00 2001 From: James E Keenan Date: Wed, 17 Feb 2021 13:31:45 +0000 Subject: Show how to quote spaces in Configure invocations For: https://github.com/Perl/perl5/issues/18573 --- INSTALL | 26 +++++++++++++++++++++++++- t/porting/known_pod_issues.dat | 1 + 2 files changed, 26 insertions(+), 1 deletion(-) diff --git a/INSTALL b/INSTALL index 6c75ea0e78..df62c5052a 100644 --- a/INSTALL +++ b/INSTALL @@ -132,7 +132,31 @@ Configure supports a number of useful options. Run Configure -h -to get a listing. See the F file for a complete list of +to get a listing. + +Many Configure switches are expressed as C pairs, for example: + + -Dcc=clang + +Sometimes the value to be supplied for a switch is a string which contains +spaces. In that case, the value needs to be quoted so as to delimit that +"shell word" from any following switch. Example: + + sh ./Configure -des \ + -Doptimize="-O2 -pipe -fstack-protector -fno-strict-aliasing" \ + -Dusedevel + +Once Configure has run, you will be able to access configuration data via +entries in the file F. + + config_arg0='./Configure' + config_args='-des -Doptimize=-O2 -pipe -fstack-protector -fno-strict-aliasing -Dusedevel' + config_argc=3 + config_arg1='-des' + config_arg2='-Doptimize=-O2 -pipe -fstack-protector -fno-strict-aliasing' + config_arg3='-Dusedevel' + +See the F file for a complete list of Configure variables you can set and their definitions. =over 4 diff --git a/t/porting/known_pod_issues.dat b/t/porting/known_pod_issues.dat index cc720a0e2d..2164ee3179 100644 --- a/t/porting/known_pod_issues.dat +++ b/t/porting/known_pod_issues.dat @@ -384,6 +384,7 @@ ext/pod-html/testdir/perlvar-copy.pod ? Should you be using L<...> instead of 3 ext/pod-html/testdir/perlvar-copy.pod Verbatim line length including indents exceeds 78 by 5 ext/vms-filespec/lib/vms/filespec.pm Verbatim line length including indents exceeds 78 by 1 install ? Should you be using F<...> or maybe L<...> instead of 1 +install Verbatim line length including indents exceeds 78 by 2 pod/perl.pod Verbatim line length including indents exceeds 78 by 5 pod/perlandroid.pod Verbatim line length including indents exceeds 78 by 3 pod/perlbook.pod Verbatim line length including indents exceeds 78 by 1 -- cgit v1.2.1