Re: [PATCH] 5.004_58 | _04 DynaLoader.pm -> DynaLoader.pm.PL (resend)
[perl.git] / README.dos
1 This is a DOS/DJGPP port of Perl 5.004_5x
2
3 1. Installation
4    ------------
5
6    - Unzip the binary package perl54b.zip preserving the directory
7      structure (-d switch to PKUNZIP) from the top DJGPP directory.
8      If you want to use perl with long file names (win0.95), then use a LFN
9      aware unzip and add
10
11               set LFN=y
12
13      to your autoexec.bat or DJGPP.ENV.
14
15    - Edit lib/perl5/Config.pm, and replace every 'c:/djgpp' with your
16      DJGPP root directory. This can be done with perl too:
17    
18               perl -i~ -pe "s!c:/djgpp!x:/djroot!i;" lib/perl5/Config.pm
19                                        ^^^^^^^^^
20                         Substitute this with your DJGPP root directory!
21
22    - This version of perl searches its library files in '../lib/perl5/',
23      which is relative to the path of perl.exe. If you don't like this,
24      you can use the PERL5LIB environment variable to tell perl where 
25      the library is. E.g:
26      
27               set PERL5LIB=c:/perl/lib
28               
29      Warning: if you set PERL5LIB and use tainting checks (-T command line 
30      option), perl ignores PERL5LIB, so you must use the -I command line
31      switch or the "use lib '...'"  construct. Or you can patch perl.exe :)
32
33    - Perl works best with a unixy shell, so you may want to download and
34      install bash (bshXXXXb.zip from the usual DJGPP sites). After installing
35      it make the 'SHELL' environment variable point to your bash.exe.
36      Finally create a `link' to your bash.exe in your %DJDIR%/bin directory:
37
38               ln -s bash.exe sh.exe
39      or
40               stubify -g sh.exe
41               stubedit sh.exe runfile=bash
42
43    - The documentation is in lib/perl5/pod. You can read the .pod files
44      with any editor, or you can use the `perldoc' utility. For more info:
45
46               perl -S perldoc -h
47
48      It tries to use less.exe or more.com, but you can set your pager with:
49      
50               SET PAGER=path_of_your_favourite_pager
51
52 2. Building Perl
53    -------------
54
55    - In addition to the standard DJGPP tools, you will need sed, gawk, grep,
56      sh-utils, textutils, fileutils, bash, diffutils, make and findutils. :-)
57      You can find them on the usual DJGPP sites. If you want to build perl
58      under win0.95, then you MUST use fileutils 3.16+ (3.13 doesn't work).
59
60    - Unzip the source package perl54s.zip preserving the directory
61      structure (-d switch to PKUNZIP) from the top DJGPP directory.
62      Under plain DOS, use the -o switch too when unzipping.
63      This creates the directory gnu/perl5004.
64
65    - Create a symlink or copy your bash.exe to sh.exe in your DJGPP/bin
66      directory.
67
68               ln -s bash.exe sh.exe
69
70      And make the 'SHELL' environment variable point to this sh.exe:
71
72               set SHELL=c:/djgpp/bin/sh.exe (use full path name!)
73
74      You can do this in djgpp.env too. Add this line BEFORE any section
75      definition:
76
77               +SHELL=%DJDIR%/bin/sh.exe
78
79    - If you have split.exe and gsplit.exe in your path, then rename split.exe
80      to djsplit.exe, and gsplit.exe to split.exe.
81
82    - Copy or link gecho.exe to echo.exe if you don't have echo.exe.
83
84    - Copy or link gawk.exe to awk.exe if you don't have awk.exe.
85
86    - Chdir to the gnu/perl5004/djgpp directory and type the following
87      command:
88
89               configure.bat
90
91      This will do some preprocessing then run the Configure script.
92
93      The Configure script is interactive, but in most of the cases you
94      just need to press ENTER.
95
96      If the script says that your package is incomplete, and ask whether
97      to continue, just answer with Y (this can only happen if you don't use
98      long filenames).
99
100      When Configure asks about the extensions, I suggest IO and Fcntl,
101      and if you want database handling then SDBM_File or GDBM_File
102      (you need to install gdbm for this one). If you want to use the 
103      POSIX extension (this is the default), make sure that the stack 
104      size of your cc1.exe is at least 512kbyte (you can check this 
105      with: stubedit cc1.exe).
106      
107         You can use the Configure script in non-interactive mode too. 
108         When I've built my perl.exe, I used this:
109
110                  configure.bat -Uuseposix -dEs
111
112         then edited config.sh (set hostname & domainname), then
113
114                  sh Configure -S
115
116         You can find more info about Configure's command line switches in
117         the `INSTALL' file.
118
119    - When the script ends, and you want to change some values in the
120      generated config.sh file, then run
121
122               sh Configure -S
123
124      after you made your modifications.
125
126      IMPORTANT: if you use this -S switch, be sure to delete the CONFIG
127      environment variable before running the script:
128
129               set CONFIG=
130
131    - Now you can compile Perl. Type:
132
133               make
134
135    - Run the tests:
136
137               make test
138
139      You should see "All tests successful" if you configured a database
140      manager, and 1 failed test script if not (lib/anydbm.t). If you
141      configured POSIX you will see 4 failed subtests in lib/posix.t.
142
143    - If you want the documentation in HTML format, then read INSTALL in
144      the main perl5004 source directory.
145
146      WARNING: if you want to use absolute path names with `installhtml',
147      use something like this:
148
149              --htmldir=f:/html
150              --htmlroot='/f|/html'     # "|" instead of ":" !!!
151
152      or NETSCAPE does strange things.
153
154    - If you don't want to use the modules, then you are ready: copy perl.exe
155      into your bin directory.
156
157    - Else install the files with:
158
159               make install
160
161  Enjoy.
162
163                                Laszlo Molnar <molnarl@cdata.tvnet.hu>
164