[p5sagit/p5-mst-13.2.git] / README.dos

This is a DOS/DJGPP port of Perl 5.004_5x

1. Installation
   ------------

   - Unzip the binary package perl54b.zip preserving the directory
     structure (-d switch to PKUNZIP) from the top DJGPP directory.
     If you want to use perl with long file names (win0.95), then use a LFN
     aware unzip and add

              set LFN=y

     to your autoexec.bat or DJGPP.ENV.

   - Edit lib/perl5/Config.pm, and replace every 'c:/djgpp' with your
     DJGPP root directory. This can be done with perl too:
   
              perl -i~ -pe "s!c:/djgpp!x:/djroot!i;" lib/perl5/Config.pm
                                       ^^^^^^^^^
                        Substitute this with your DJGPP root directory!

   - This version of perl searches its library files in '../lib/perl5/',
     which is relative to the path of perl.exe. If you don't like this,
     you can use the PERL5LIB environment variable to tell perl where 
     the library is. E.g:
     
              set PERL5LIB=c:/perl/lib
              
     Warning: if you set PERL5LIB and use tainting checks (-T command line 
     option), perl ignores PERL5LIB, so you must use the -I command line
     switch or the "use lib '...'"  construct. Or you can patch perl.exe :)

   - Perl works best with a unixy shell, so you may want to download and
     install bash (bshXXXXb.zip from the usual DJGPP sites). After installing
     it make the 'SHELL' environment variable point to your bash.exe.
     Finally create a `link' to your bash.exe in your %DJDIR%/bin directory:

              ln -s bash.exe sh.exe
     or
              stubify -g sh.exe
              stubedit sh.exe runfile=bash

   - The documentation is in lib/perl5/pod. You can read the .pod files
     with any editor, or you can use the `perldoc' utility. For more info:

              perl -S perldoc -h

     It tries to use less.exe or more.com, but you can set your pager with:
     
              SET PAGER=path_of_your_favourite_pager

2. Building Perl
   -------------

   - In addition to the standard DJGPP tools, you will need sed, gawk, grep,
     sh-utils, textutils, fileutils, bash, diffutils, make and findutils. :-)
     You can find them on the usual DJGPP sites. If you want to build perl
     under win0.95, then you MUST use fileutils 3.16+ (3.13 doesn't work).

   - Unzip the source package perl54s.zip preserving the directory
     structure (-d switch to PKUNZIP) from the top DJGPP directory.
     Under plain DOS, use the -o switch too when unzipping.
     This creates the directory gnu/perl5004.

   - Create a symlink or copy your bash.exe to sh.exe in your DJGPP/bin
     directory.

              ln -s bash.exe sh.exe

     And make the 'SHELL' environment variable point to this sh.exe:

              set SHELL=c:/djgpp/bin/sh.exe (use full path name!)

     You can do this in djgpp.env too. Add this line BEFORE any section
     definition:

              +SHELL=%DJDIR%/bin/sh.exe

   - If you have split.exe and gsplit.exe in your path, then rename split.exe
     to djsplit.exe, and gsplit.exe to split.exe.

   - Copy or link gecho.exe to echo.exe if you don't have echo.exe.

   - Copy or link gawk.exe to awk.exe if you don't have awk.exe.

   - Chdir to the gnu/perl5004/djgpp directory and type the following
     command:

              configure.bat

     This will do some preprocessing then run the Configure script.

     The Configure script is interactive, but in most of the cases you
     just need to press ENTER.

     If the script says that your package is incomplete, and ask whether
     to continue, just answer with Y (this can only happen if you don't use
     long filenames).

     When Configure asks about the extensions, I suggest IO and Fcntl,
     and if you want database handling then SDBM_File or GDBM_File
     (you need to install gdbm for this one). If you want to use the 
     POSIX extension (this is the default), make sure that the stack 
     size of your cc1.exe is at least 512kbyte (you can check this 
     with: stubedit cc1.exe).
     
        You can use the Configure script in non-interactive mode too. 
        When I've built my perl.exe, I used this:

                 configure.bat -Uuseposix -dEs

        then edited config.sh (set hostname & domainname), then

                 sh Configure -S

        You can find more info about Configure's command line switches in
        the `INSTALL' file.

   - When the script ends, and you want to change some values in the
     generated config.sh file, then run

              sh Configure -S

     after you made your modifications.

     IMPORTANT: if you use this -S switch, be sure to delete the CONFIG
     environment variable before running the script:

              set CONFIG=

   - Now you can compile Perl. Type:

              make

   - Run the tests:

              make test

     You should see "All tests successful" if you configured a database
     manager, and 1 failed test script if not (lib/anydbm.t). If you
     configured POSIX you will see 4 failed subtests in lib/posix.t.

   - If you want the documentation in HTML format, then read INSTALL in
     the main perl5004 source directory.

     WARNING: if you want to use absolute path names with `installhtml',
     use something like this:

             --htmldir=f:/html
             --htmlroot='/f|/html'     # "|" instead of ":" !!!

     or NETSCAPE does strange things.

   - If you don't want to use the modules, then you are ready: copy perl.exe
     into your bin directory.

   - Else install the files with:

              make install

 Enjoy.

                               Laszlo Molnar <molnarl@cdata.tvnet.hu>
Commit	Line	Data
39e571d4	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