-for most things. Some things to watch out for are
-
- - this port does support dynamic loading but it's not had much testing
-
- - Don't turn on the compiler optimization flag "-O". There's
- a bug in the compiler (APAR PQ18812) that generates some bad code
- the optimizer is on.
-
- - As VM/ESA doesn't fully support the fork() API programs relying on
- this call will not work. I've replaced fork()/exec() with spawn()
- and the standalone exec() with spawn(). This has a side effect when
- opening unnamed pipes in a shell script: there is no child process
- generated under.
-
- - At the moment the hints file for VM/ESA basically bypasses all of the
- automatic configuration process. This is because Configure relies on:
- 1. The header files living in the Byte File System (you could put the
- there if you want;
- 2. The C preprocessor including the #include statements in the
- preprocessor output (.i) file.
-
+for most things. Some things to watch out for are:
+
+=over 4
+
+=item *
+
+this port does support dynamic loading but it's not had much testing
+
+=item *
+
+Don't turn on the compiler optimization flag "-O". There's
+a bug in the compiler (APAR PQ18812) that generates some bad code
+the optimizer is on.
+
+=item *
+
+As VM/ESA doesn't fully support the fork() API programs relying on
+this call will not work. I've replaced fork()/exec() with spawn()
+and the standalone exec() with spawn(). This has a side effect when
+opening unnamed pipes in a shell script: there is no child process
+generated under.
+
+=item *
+
+At the moment the hints file for VM/ESA basically bypasses all of the
+automatic configuration process. This is because Configure relies on:
+1. The header files living in the Byte File System (you could put the
+there if you want); 2. The C preprocessor including the #include
+statements in the preprocessor output (.i) file.
+
+=back
+
+=head2 Testing Anomalies of Perl on VM/ESA
+
+The "make test" step runs a Perl Verification Procedure, usually before
+installation. As the 5.6.1 kit was being assembled
+the following "failures" were known to appear on some machines
+during "make test" (mostly due to ASCII vs. EBCDIC conflicts),
+your results may differ:
+
+[the list of failures being compiled]
+
+=head2 Usage Hints for Perl on VM/ESA
+