summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--INSTALL26
-rw-r--r--t/porting/known_pod_issues.dat1
2 files changed, 26 insertions, 1 deletions
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<Porting/Glossary> file for a complete list of
+to get a listing.
+
+Many Configure switches are expressed as C<key=value> 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.sh>.
+
+ 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<Porting/Glossary> 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