- Automated Testing of Perl5.6.1 Interpreter for NetWare.
+ Automated Testing of Perl5 Interpreter for NetWare.
-A set of Standard Unit Test Scripts to test all the functionalities of Perl 5.6.1 Interpreter are available along with the CPAN download. They are all located under 't' folder. These include sub-folders under 't' folder: 'base', 'cmd', 'comp', 'io', lib', 'op', 'pod', 'pragma', 'run'. Each of these sub-folders contain few test scripts ('.t' files) under them.
+A set of Standard Unit Test Scripts to test all the functionalities of
+Perl5 Interpreter are available along with the CPAN download. They are
+all located under 't' folder. These include sub-folders under 't' such
+as: 'base', 'cmd', 'comp', 'io', lib', 'op', 'pod', 'pragma' and 'run'.
+Each of these sub-folders contain few test scripts ('.t' files) under
+them.
-Executing these test scripts on NetWare can be automated as per the following:
+Executing these test scripts on NetWare can be automated as per the
+following:
-1. Automated scripts, 'base.pl', 'cmd.pl', 'comp.pl', 'io.pl', 'lib.pl', 'op.pl', 'pod.pl', 'pragma.pl', 'run.pl' can be generated that are used to execute all the test scripts ('.t' files) under the corresponding folder.
-For example, 'base.pl' tests all the test scripts under 'sys:\perl\scripts\t\base' folder, 'comp.pl' test all scripts under 'sys:\perl\scripts\t\comp' folder and so on.
+1. Generate automated scripts like 'base.pl', 'cmd.pl', 'comp.pl', 'io.pl',
+'lib.pl', 'op.pl', 'pod.pl', 'pragma.pl', 'run.pl' that execute all the
+test scripts ('.t' files) under the corresponding folder.
-2. An automated script, 'auto.pl' can also be generated that executes all the above mentioned '.pl' automated scripts, thus executing all the '.t' scripts.
+For example, 'base.pl' to test all the scripts
+ under 'sys:\perl\scripts\t\base' folder,
+ 'comp.pl' to test all the scripts
+ under 'sys:\perl\scripts\t\comp' folder and so on.
-There is a script 'NWScripts.pl' available under the 'NetWare\t' folder of the CPAN download. This is written to generate these automated scripts when executed on a NetWare server. It generates the automated scripts, 'base.pl', 'cmd.pl', 'comp.pl', 'io.pl', 'lib.pl', 'op.pl', 'pod.pl', 'pragma.pl', 'run.pl' and also 'auto.pl' by including all the corresponding '.t' scripts in them. For example, all the scripts that are under 't\base' folder will be entered in 'base.pl' and so on. 'auto.pl will include all these '.pl' scripts like 'base.pl', 'comp.pl' etc.
+2. Generate an automated script, 'nwauto.pl' that executes all the above
+mentioned '.pl' automated scripts, thus in turn executing all the '.t'
+scripts.
+The script, 'NWScripts.pl' available under the 'NetWare\t' folder of the
+CPAN download, is written to generate these automated scripts when
+executed on a NetWare server. It generates 'base.pl', 'cmd.pl', 'comp.pl',
+'io.pl', 'lib.pl', 'op.pl', 'pod.pl', 'pragma.pl', 'run.pl' and also
+'nwauto.pl' by including all the corresponding '.t' scripts in them in
+backtick operators.
-The following steps elicits the procedure for executing the automated scripts:
+For example, all the scripts that are under 't\base' folder will be
+entered in 'base.pl' and so on. 'nwauto.pl' includes all these '.pl'
+scripts like 'base.pl', 'comp.pl' etc.
-1. Copy the 't' folder from the CPAN download to 'sys:\perl\scripts' folder on the NetWare server.
+Perform the following steps to execute the automated scripts:
-2. Copy all the files from 'NetWare\t' folder of the CPAN download into 'sys:\perl\scripts\t' folder.
+1. Make sure that your NetWare server is mapped to "i:".
+
+2. Execute "nmake nwinstall" (after building interpreter and extensions)
+in the 'NetWare' folder of the CPAN download. This installs all the
+library files, perl modules and all the 't' scripts in appropriate
+folders onto your server.
+
+3. Execute the command "perl t\NWModify.pl" on the console command
+prompt of your server. This script replaces
-3. Execute the command "perl t\NWModify.pl" on the console command prompt. This script replaces
"@INC = " with "unshift @INC, " and
"push @INC, " with "unshift @INC, "
- from all the scripts under 'sys:\perl\scripts\t' folder.
-This is done to include the correct path for libraries into the scripts when executed on NetWare. If this is not done, some of the scripts will not get executed since they cannot locate the corresponding libraries.
+from all the scripts under 'sys:\perl\scripts\t' folder.
+
+This is done to include the correct path for libraries into the scripts
+when executed on NetWare. If this is not done, some of the scripts will
+not get executed since they cannot locate the corresponding libraries.
+
+4. Execute the command "perl t\NWScripts.pl" on the console command
+prompt to generate the automated scripts mentioned above
+under the 'sys:\perl\scripts\t' folder.
-4. Execute the command "perl t\NWScripts.pl" on the console command prompt to generate the automated scripts mentioned above under the 'sys:\perl\scripts\t' folder.
- (See above for details).
+5. Execute the command "perl t\nwauto.pl" on the server console command
+prompt. This runs all the standard test scripts. If you desire to
+redirect or save the results into a file, say 'nwauto.txt', then the
+console command to execute is: "perl t\nwauto.pl > nwauto.txt".
-5. Execute 'auto.pl' script using the server console command, "perl t\auto.pl" to run all the standard test scripts. If you want the results to be redirected into a file, say 'auto.txt', then the console command is: "perl t\auto.pl > auto.txt"
+6. If you wish to execute only a certain set of scripts, then run the
+corresponding '.pl' file. For example, if you wish to execute only the
+'lib' scripts, then execute 'lib.pl' through the server console command,
+"perl t\lib.pl'. To redirect the results into a file, the console command
+ is, "perl t\lib.pl > lib.txt".
-6. If you want to execute certain set of scripts, then run the corresponding '.pl' file. For example, if you want to execute only the 'lib' scripts, then execute 'run.pl' through the server console command, "perl t\run.pl'. To redirect the results into a file, the console command could be, "perl t\run.pl > run.txt".
Known Issues:
1. 'openpid.t' in 'sys:\perl\scripts\t\io.pl' script
Reason:
- This either hangs or abends the server when executing through auto scripts.
- When run individually, the script execution goes through fine.
+ This either hangs or abends the server when executing through auto
+ scripts. When run individually, the script execution goes through
+ fine.
2. 'argv.t' in 'sys:\perl\scripts\t\io.pl' script
Reason:
- This either hangs or abends the server when executing through auto scripts.
- When run individually, the script execution goes through fine.
+ This either hangs or abends the server when executing through auto
+ scripts. When run individually, the script execution goes through
+ fine.
-3. 'filehand.t' in 'sys:\perl\scripts\t\lib.pl' script
+3. 'filehandle.t' in 'sys:\perl\scripts\t\lib.pl' script
Reason:
- This hangs in the last test case where it uses FileHandle::Pipe whether run individually
- or through an auto script.
+ This hangs in the last test case where it uses FileHandle::Pipe
+ whether run individually or through an auto script.
projects / p5sagit/p5-mst-13.2.git / blobdiff