Update info on number of magic types\n\nRemove mention of overloading being optional
[p5sagit/p5-mst-13.2.git] / NetWare / t / Readme.txt
CommitLineData
2986a63f 1
2
225a5dca 3 Automated Testing of Perl5 Interpreter for NetWare.
2986a63f 4
5
6
32ce01bc 7A set of Standard Unit Test Scripts to test all the functionalities of
8Perl5 Interpreter are available along with the CPAN download. They are
9all located under 't' folder. These include sub-folders under 't' such
10as: 'base', 'cmd', 'comp', 'io', lib', 'op', 'pod', 'pragma' and 'run'.
11Each of these sub-folders contain few test scripts ('.t' files) under
12them.
13
14Executing these test scripts on NetWare can be automated as per the
15following:
16
171. Generate automated scripts like 'base.pl', 'cmd.pl', 'comp.pl', 'io.pl',
18'lib.pl', 'op.pl', 'pod.pl', 'pragma.pl', 'run.pl' that execute all the
19test scripts ('.t' files) under the corresponding folder.
20
21For example, 'base.pl' to test all the scripts
22 under 'sys:\perl\scripts\t\base' folder,
23 'comp.pl' to test all the scripts
24 under 'sys:\perl\scripts\t\comp' folder and so on.
25
262. Generate an automated script, 'nwauto.pl' that executes all the above
27mentioned '.pl' automated scripts, thus in turn executing all the '.t'
28scripts.
29
30The script, 'NWScripts.pl' available under the 'NetWare\t' folder of the
31CPAN download, is written to generate these automated scripts when
32executed on a NetWare server. It generates 'base.pl', 'cmd.pl', 'comp.pl',
33'io.pl', 'lib.pl', 'op.pl', 'pod.pl', 'pragma.pl', 'run.pl' and also
34'nwauto.pl' by including all the corresponding '.t' scripts in them in
35backtick operators.
36
37For example, all the scripts that are under 't\base' folder will be
38entered in 'base.pl' and so on. 'nwauto.pl' includes all these '.pl'
39scripts like 'base.pl', 'comp.pl' etc.
40
a521c331 41
32ce01bc 42Perform the following steps to execute the automated scripts:
2986a63f 43
a521c331 441. Map your NetWare server to "i:"
2986a63f 45
a521c331 462. After complete build (building both interpreter and all extensions)
47of Perl for NetWare, execute "nmake nwinstall" in the 'NetWare' folder
48of the CPAN download. This installs all the library files, perl modules,
49the '.pl' files under 'NetWare\t' folder and all the '.t' scripts
50under 't' folder, all in appropriate folders onto your server.
2986a63f 51
32ce01bc 523. Execute the command "perl t\NWModify.pl" on the console command
53prompt of your server. This script replaces
225a5dca 54
2986a63f 55 "@INC = " with "unshift @INC, " and
56 "push @INC, " with "unshift @INC, "
2986a63f 57
32ce01bc 58from all the scripts under 'sys:\perl\scripts\t' folder.
59
60This is done to include the correct path for libraries into the scripts
61when executed on NetWare. If this is not done, some of the scripts will
62not get executed since they cannot locate the corresponding libraries.
2986a63f 63
32ce01bc 644. Execute the command "perl t\NWScripts.pl" on the console command
65prompt to generate the automated scripts mentioned above
66under the 'sys:\perl\scripts\t' folder.
225a5dca 67
32ce01bc 685. Execute the command "perl t\nwauto.pl" on the server console command
69prompt. This runs all the standard test scripts. If you desire to
70redirect or save the results into a file, say 'nwauto.txt', then the
71console command to execute is: "perl t\nwauto.pl > nwauto.txt".
2986a63f 72
32ce01bc 736. If you wish to execute only a certain set of scripts, then run the
74corresponding '.pl' file. For example, if you wish to execute only the
75'lib' scripts, then execute 'lib.pl' through the server console command,
76"perl t\lib.pl'. To redirect the results into a file, the console command
77 is, "perl t\lib.pl > lib.txt".
2986a63f 78
2986a63f 79
80
81Known Issues:
82
83The following scripts are commented out in the corresponding autoscript:
84
851. 'openpid.t' in 'sys:\perl\scripts\t\io.pl' script
86 Reason:
32ce01bc 87 This either hangs or abends the server when executing through auto
88 scripts. When run individually, the script execution goes through
89 fine.
2986a63f 90
912. 'argv.t' in 'sys:\perl\scripts\t\io.pl' script
92 Reason:
32ce01bc 93 This either hangs or abends the server when executing through auto
94 scripts. When run individually, the script execution goes through
95 fine.
2986a63f 96
225a5dca 973. 'filehandle.t' in 'sys:\perl\scripts\t\lib.pl' script
2986a63f 98 Reason:
32ce01bc 99 This hangs in the last test case where it uses FileHandle::Pipe
100 whether run individually or through an auto script.
2986a63f 101