-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>
-
+If you read this file _as_is_, just ignore the funny characters you\r
+see. It is written in the POD format (see perlpod manpage) which is\r
+specially designed to be readable as is.\r
+\r
+=head1 NAME\r
+\r
+perldos - Perl under DOS, W31, W95.\r
+\r
+=head1 SYNOPSIS\r
+\r
+These are instructions for building Perl under DOS (or w??), using\r
+DJGPP v2.03 or later. Under w95 long filenames are supported.\r
+\r
+=head1 DESCRIPTION\r
+\r
+Before you start, you should glance through the README file\r
+found in the top-level directory where the Perl distribution\r
+was extracted. Make sure you read and understand the terms under\r
+which this software is being distributed.\r
+\r
+This port currently supports MakeMaker (the set of modules that\r
+is used to build extensions to perl). Therefore, you should be\r
+able to build and install most extensions found in the CPAN sites.\r
+\r
+Detailed instructions on how to build and install perl extension\r
+modules, including XS-type modules, is included. See 'BUILDING AND\r
+INSTALLING MODULES'.\r
+\r
+=head2 Prerequisites for Compiling Perl on DOS\r
+\r
+=over 4\r
+\r
+=item DJGPP\r
+\r
+DJGPP is a port of GNU C/C++ compiler and development tools to 32-bit,\r
+protected-mode environment on Intel 32-bit CPUs running MS-DOS and compatible\r
+operating systems, by DJ Delorie <dj@delorie.com> and friends.\r
+\r
+For more details (FAQ), check out the home of DJGPP at:\r
+\r
+ http://www.delorie.com/djgpp/\r
+\r
+If you have questions about DJGPP, try posting to the DJGPP newsgroup:\r
+comp.os.msdos.djgpp, or use the email gateway djgpp@delorie.com.\r
+\r
+You can find the full DJGPP distribution on any SimTel.Net mirror all over\r
+the world. Like:\r
+\r
+ ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2*\r
+\r
+You need the following files to build perl (or add new modules):\r
+\r
+ v2/djdev203.zip\r
+ v2/bnu2951b.zip\r
+ v2gnu/gcc2952b.zip\r
+ v2gnu/bsh204b.zip\r
+ v2gnu/mak3791b.zip\r
+ v2gnu/fil316b.zip\r
+ v2gnu/sed302b.zip\r
+ v2gnu/txt20b.zip\r
+ v2gnu/dif272b.zip\r
+ v2gnu/grep24b.zip\r
+ v2gnu/shl112b.zip\r
+ v2gnu/gawk303b.zip\r
+ v2misc/csdpmi4b.zip\r
+\r
+or possibly any newer version.\r
+\r
+=item Pthreads\r
+\r
+Thread support is not tested in this version of the djgpp perl.\r
+\r
+=back\r
+\r
+=head2 Shortcomings of Perl under DOS\r
+\r
+Perl under DOS lacks some features of perl under UNIX because of\r
+deficiencies in the UNIX-emulation, most notably:\r
+\r
+=over 4\r
+\r
+=item *\r
+\r
+fork() and pipe()\r
+\r
+=item *\r
+\r
+some features of the UNIX filesystem regarding link count and file dates\r
+\r
+=item *\r
+\r
+in-place operation is a little bit broken with short filenames\r
+\r
+=item *\r
+\r
+sockets\r
+\r
+=back\r
+\r
+=head2 Building Perl on DOS\r
+\r
+=over 4\r
+\r
+=item *\r
+\r
+Unpack the source package F<perl5.6*.tar.gz> with djtarx. If you want\r
+to use long file names under w95 and also to get Perl to pass all its\r
+tests, don't forget to use\r
+\r
+ set LFN=y\r
+ set FNCASE=y\r
+\r
+before unpacking the archive.\r
+\r
+=item *\r
+\r
+Create a "symlink" or copy your bash.exe to sh.exe in your C<($DJDIR)/bin>\r
+directory.\r
+\r
+ ln -s bash.exe sh.exe\r
+\r
+[If you have the recommended version of bash for DJGPP, this is already\r
+done for you.]\r
+\r
+And make the C<SHELL> environment variable point to this F<sh.exe>:\r
+\r
+ set SHELL=c:/djgpp/bin/sh.exe (use full path name!)\r
+\r
+You can do this in F<djgpp.env> too. Add this line BEFORE any section\r
+definition:\r
+\r
+ +SHELL=%DJDIR%/bin/sh.exe\r
+\r
+=item *\r
+\r
+If you have F<split.exe> and F<gsplit.exe> in your path, then rename \r
+F<split.exe> to F<djsplit.exe>, and F<gsplit.exe> to F<split.exe>.\r
+Copy or link F<gecho.exe> to F<echo.exe> if you don't have F<echo.exe>.\r
+Copy or link F<gawk.exe> to F<awk.exe> if you don't have F<awk.exe>.\r
+\r
+[If you have the recommended versions of djdev, shell utilities and\r
+gawk, all these are already done for you, and you will not need to do\r
+anything.]\r
+\r
+=item *\r
+\r
+Chdir to the djgpp subdirectory of perl toplevel and type the following\r
+commands:\r
+\r
+ set FNCASE=y\r
+ configure.bat\r
+\r
+This will do some preprocessing then run the Configure script for you.\r
+The Configure script is interactive, but in most cases you just need to\r
+press ENTER. The "set" command ensures that DJGPP preserves the letter\r
+case of file names when reading directories. If you already issued this\r
+set command when unpacking the archive, and you are in the same DOS\r
+session as when you unpacked the archive, you don't have to issue the\r
+set command again. This command is necessary *before* you start to \r
+(re)configure or (re)build perl in order to ensure both that perl builds \r
+correctly and that building XS-type modules can succeed. See the DJGPP \r
+info entry for "_preserve_fncase" for more information:\r
+\r
+ info libc alphabetical _preserve_fncase\r
+\r
+If the script says that your package is incomplete, and asks whether\r
+to continue, just answer with Y (this can only happen if you don't use\r
+long filenames or forget to issue "set FNCASE=y" first).\r
+\r
+When Configure asks about the extensions, I suggest IO and Fcntl,\r
+and if you want database handling then SDBM_File or GDBM_File\r
+(you need to install gdbm for this one). If you want to use the\r
+POSIX extension (this is the default), make sure that the stack\r
+size of your F<cc1.exe> is at least 512kbyte (you can check this\r
+with: C<stubedit cc1.exe>).\r
+\r
+You can use the Configure script in non-interactive mode too.\r
+When I built my F<perl.exe>, I used something like this:\r
+\r
+ configure.bat -des\r
+\r
+You can find more info about Configure's command line switches in\r
+the F<INSTALL> file.\r
+\r
+When the script ends, and you want to change some values in the\r
+generated F<config.sh> file, then run\r
+\r
+ sh Configure -S\r
+\r
+after you made your modifications.\r
+\r
+IMPORTANT: if you use this C<-S> switch, be sure to delete the CONFIG\r
+environment variable before running the script:\r
+\r
+ set CONFIG=\r
+\r
+=item *\r
+\r
+Now you can compile Perl. Type:\r
+\r
+ make\r
+\r
+=back\r
+\r
+=head2 Testing Perl on DOS\r
+\r
+Type:\r
+\r
+ make test\r
+\r
+If you're lucky you should see "All tests successful". But there can be\r
+a few failed subtests (less than 5 hopefully) depending on some external\r
+conditions (e.g. some subtests fail under linux/dosemu or plain dos\r
+with short filenames only).\r
+\r
+=head2 Installation of Perl on DOS\r
+\r
+Type:\r
+\r
+ make install\r
+\r
+This will copy the newly compiled perl and libraries into your DJGPP\r
+directory structure. Perl.exe and the utilities go into C<($DJDIR)/bin>,\r
+and the library goes under C<($DJDIR)/lib/perl5>. The pod documentation\r
+goes under C<($DJDIR)/lib/perl5/pod>.\r
+\r
+=head1 BUILDING AND INSTALLING MODULES ON DOS\r
+\r
+=head2 Building Prerequisites for Perl on DOS\r
+\r
+For building and installing non-XS modules, all you need is a working\r
+perl under DJGPP. Non-XS modules do not require re-linking the perl\r
+binary, and so are simpler to build and install.\r
+\r
+XS-type modules do require re-linking the perl binary, because part of\r
+an XS module is written in "C", and has to be linked together with the\r
+perl binary to be executed. This is required because perl under DJGPP\r
+is built with the "static link" option, due to the lack of "dynamic\r
+linking" in the DJGPP environment.\r
+\r
+Because XS modules require re-linking of the perl binary, you need both\r
+the perl binary distribution and the perl source distribution to build\r
+an XS extension module. In addition, you will have to have built your\r
+perl binary from the source distribution so that all of the components\r
+of the perl binary are available for the required link step.\r
+\r
+=head2 Unpacking CPAN Modules on DOS\r
+\r
+First, download the module package from CPAN (e.g., the "Comma Separated\r
+Value" text package, Text-CSV-0.01.tar.gz). Then expand the contents of\r
+the package into some location on your disk. Most CPAN modules are\r
+built with an internal directory structure, so it is usually safe to\r
+expand it in the root of your DJGPP installation. Some people prefer to\r
+locate source trees under /usr/src (i.e., C<($DJDIR)/usr/src>), but you may\r
+put it wherever seems most logical to you, *EXCEPT* under the same\r
+directory as your perl source code. There are special rules that apply\r
+to modules which live in the perl source tree that do not apply to most\r
+of the modules in CPAN.\r
+\r
+Unlike other DJGPP packages, which are normal "zip" files, most CPAN\r
+module packages are "gzipped tarballs". Recent versions of WinZip will\r
+safely unpack and expand them, *UNLESS* they have zero-length files. It\r
+is a known WinZip bug (as of v7.0) that it will not extract zero-length\r
+files.\r
+\r
+From the command line, you can use the djtar utility provided with DJGPP\r
+to unpack and expand these files. For example:\r
+\r
+ C:\djgpp>djtarx -v Text-CSV-0.01.tar.gz\r
+\r
+This will create the new directory C<($DJDIR)/Text-CSV-0.01>, filling\r
+it with the source for this module.\r
+\r
+=head2 Building Non-XS Modules on DOS\r
+\r
+To build a non-XS module, you can use the standard module-building\r
+instructions distributed with perl modules.\r
+\r
+ perl Makefile.PL\r
+ make\r
+ make test\r
+ make install\r
+\r
+This is sufficient because non-XS modules install only ".pm" files and\r
+(sometimes) pod and/or man documentation. No re-linking of the perl\r
+binary is needed to build, install or use non-XS modules.\r
+\r
+=head2 Building XS Modules on DOS\r
+\r
+To build an XS module, you must use the standard module-building\r
+instructions distributed with perl modules *PLUS* three extra\r
+instructions specific to the DJGPP "static link" build environment.\r
+\r
+ set FNCASE=y\r
+ perl Makefile.PL\r
+ make\r
+ make perl\r
+ make test\r
+ make -f Makefile.aperl inst_perl MAP_TARGET=perl.exe\r
+ make install\r
+\r
+The first extra instruction sets DJGPP's FNCASE environment variable so\r
+that the new perl binary which you must build for an XS-type module will\r
+build correctly. The second extra instruction re-builds the perl binary\r
+in your module directory before you run "make test", so that you are\r
+testing with the new module code you built with "make". The third extra\r
+instruction installs the perl binary from your module directory into the\r
+standard DJGPP binary directory, C<($DJDIR)/bin>, replacing your\r
+previous perl binary.\r
+\r
+Note that the MAP_TARGET value *must* have the ".exe" extension or you\r
+will not create a "perl.exe" to replace the one in C<($DJDIR)/bin>.\r
+\r
+When you are done, the XS-module install process will have added information\r
+to yout "perllocal" information telling that the perl binary has been replaced,\r
+and what module was installed. you can view this information at any time\r
+by using the command:\r
+\r
+ perl -S perldoc perllocal\r
+\r
+=head1 AUTHOR\r
+\r
+Laszlo Molnar, F<laszlo.molnar@eth.ericsson.se> [Installing/building perl]\r
+\r
+Peter J. Farley III F<pjfarley@banet.net> [Building/installing modules]\r
+\r
+=head1 SEE ALSO\r
+\r
+perl(1).\r
+\r
+=cut\r
+\r