diff options
Diffstat (limited to 'README.dos')
-rw-r--r-- | README.dos | 430 |
1 files changed, 215 insertions, 215 deletions
diff --git a/README.dos b/README.dos index 8d42f65e98..51cd1d6f18 100644 --- a/README.dos +++ b/README.dos @@ -1,215 +1,215 @@ -If you read this file _as_is_, just ignore the funny characters you
-see. It is written in the POD format (see perlpod manpage) which is
-specially designed to be readable as is.
-
-=head1 NAME
-
-perldos - Perl under DOS, W31, W95.
-
-=head1 SYNOPSIS
-
-These are instructions for building Perl under DOS (or w??), using
-DJGPP v2.01 or later. Under w95 long filenames are supported.
-
-=head1 DESCRIPTION
-
-Before you start, you should glance through the README file
-found in the top-level directory where the Perl distribution
-was extracted. Make sure you read and understand the terms under
-which this software is being distributed.
-
-This port currently supports MakeMaker (the set of modules that
-is used to build extensions to perl). Therefore, you should be
-able to build and install most extensions found in the CPAN sites.
-
-=head2 Prerequisites
-
-=over 4
-
-=item DJGPP
-
-DJGPP is a port of GNU C/C++ compiler and development tools to 32-bit,
-protected-mode environment on Intel 32-bit CPUs running MS-DOS and compatible
-operating systems, by DJ Delorie <dj@delorie.com> and friends.
-
-For more details (FAQ), check out the home of DJGPP at:
-
- http://www.delorie.com/djgpp/
-
-If you have questions about DJGPP, try posting to the DJGPP newsgroup:
-comp.os.msdos.djgpp, or use the email gateway djgpp@delorie.com.
-
-You can find the full DJGPP distribution on any SimTel.Net mirror all over
-the world. Like:
-
- ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2*
-
-You need the following files to build perl (or add new modules):
-
- v2/djdev202.zip
- v2/bnu27b.zip
- v2gnu/gcc2721b.zip
- v2gnu/bsh1147b.zip
- v2gnu/mak3761b.zip
- v2gnu/fil316b.zip
- v2gnu/sed118b.zip
- v2gnu/txt122b.zip
- v2gnu/dif271b.zip
- v2gnu/grep21b.zip
- v2gnu/shl112b.zip
- v2gnu/gawk303b.zip
- v2misc/csdpmi4b.zip
-
-or possibly any newer version.
-
-=item Pthreads
-
-Thread support is not tested in this version of the djgpp perl.
-
-=back
-
-=head2 Shortcomings of Perl under DOS
-
-Perl under DOS lacks some features of perl under UNIX because of
-deficiencies in the UNIX-emulation, most notably:
-
-=over 4
-
-=item *
-
-fork() and pipe()
-
-=item *
-
-some features of the UNIX filesystem regarding link count and file dates
-
-=item *
-
-in-place operation is a little bit broken with short filenames
-
-=item *
-
-sockets
-
-=back
-
-=head2 Building
-
-=over 4
-
-=item *
-
-Unpack the source package F<perl5.6*.tar.gz> with djtarx. If you want
-to use long file names under w95 and also to get Perl to pass all its
-tests, don't forget to use
-
- set LFN=y
- set FNCASE=y
-
-before unpacking the archive.
-
-=item *
-
-Create a "symlink" or copy your bash.exe to sh.exe in your C<($DJDIR)/bin>
-directory.
-
- ln -s bash.exe sh.exe
-
-And make the C<SHELL> environment variable point to this F<sh.exe>:
-
- set SHELL=c:/djgpp/bin/sh.exe (use full path name!)
-
-You can do this in F<djgpp.env> too. Add this line BEFORE any section
-definition:
-
- +SHELL=%DJDIR%/bin/sh.exe
-
-=item *
-
-If you have F<split.exe> and F<gsplit.exe> in your path, then rename
-F<split.exe> to F<djsplit.exe>, and F<gsplit.exe> to F<split.exe>.
-Copy or link F<gecho.exe> to F<echo.exe> if you don't have F<echo.exe>.
-Copy or link F<gawk.exe> to F<awk.exe> if you don't have F<awk.exe>.
-
-=item *
-
-Chdir to the djgpp subdirectory of perl toplevel and type the following
-command:
-
- configure.bat
-
-This will do some preprocessing then run the Configure script for you.
-The Configure script is interactive, but in most cases you
-just need to press ENTER.
-
-If the script says that your package is incomplete, and asks 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 F<cc1.exe> is at least 512kbyte (you can check this
-with: C<stubedit cc1.exe>).
-
-You can use the Configure script in non-interactive mode too.
-When I built my F<perl.exe>, I used something like this:
-
- configure.bat -des
-
-You can find more info about Configure's command line switches in
-the F<INSTALL> file.
-
-When the script ends, and you want to change some values in the
-generated F<config.sh> file, then run
-
- sh Configure -S
-
-after you made your modifications.
-
-IMPORTANT: if you use this C<-S> switch, be sure to delete the CONFIG
-environment variable before running the script:
-
- set CONFIG=
-
-=item *
-
-Now you can compile Perl. Type:
-
- make
-
-=back
-
-=head2 Testing
-
-Type:
-
- make test
-
-If you're lucky you should see "All tests successful". But there can be
-a few failed subtests (less than 5 hopefully) depending on some external
-conditions (e.g. some subtests fail under linux/dosemu or plain dos
-with short filenames only).
-
-=head2 Installation
-
-Type:
-
- make install
-
-This will copy the newly compiled perl and libraries into your DJGPP
-directory structure. Perl.exe and the utilities go into C<($DJDIR)/bin>,
-and the library goes under C<($DJDIR)/lib/perl5>. The pod documentation
-goes under C<($DJDIR)/lib/perl5/pod>.
-
-=head1 AUTHOR
-
-Laszlo Molnar, F<laszlo.molnar@eth.ericsson.se>
-
-=head1 SEE ALSO
-
-perl(1).
-
-=cut
-
+If you read this file _as_is_, just ignore the funny characters you +see. It is written in the POD format (see perlpod manpage) which is +specially designed to be readable as is. + +=head1 NAME + +perldos - Perl under DOS, W31, W95. + +=head1 SYNOPSIS + +These are instructions for building Perl under DOS (or w??), using +DJGPP v2.01 or later. Under w95 long filenames are supported. + +=head1 DESCRIPTION + +Before you start, you should glance through the README file +found in the top-level directory where the Perl distribution +was extracted. Make sure you read and understand the terms under +which this software is being distributed. + +This port currently supports MakeMaker (the set of modules that +is used to build extensions to perl). Therefore, you should be +able to build and install most extensions found in the CPAN sites. + +=head2 Prerequisites + +=over 4 + +=item DJGPP + +DJGPP is a port of GNU C/C++ compiler and development tools to 32-bit, +protected-mode environment on Intel 32-bit CPUs running MS-DOS and compatible +operating systems, by DJ Delorie <dj@delorie.com> and friends. + +For more details (FAQ), check out the home of DJGPP at: + + http://www.delorie.com/djgpp/ + +If you have questions about DJGPP, try posting to the DJGPP newsgroup: +comp.os.msdos.djgpp, or use the email gateway djgpp@delorie.com. + +You can find the full DJGPP distribution on any SimTel.Net mirror all over +the world. Like: + + ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2* + +You need the following files to build perl (or add new modules): + + v2/djdev202.zip + v2/bnu27b.zip + v2gnu/gcc2721b.zip + v2gnu/bsh1147b.zip + v2gnu/mak3761b.zip + v2gnu/fil316b.zip + v2gnu/sed118b.zip + v2gnu/txt122b.zip + v2gnu/dif271b.zip + v2gnu/grep21b.zip + v2gnu/shl112b.zip + v2gnu/gawk303b.zip + v2misc/csdpmi4b.zip + +or possibly any newer version. + +=item Pthreads + +Thread support is not tested in this version of the djgpp perl. + +=back + +=head2 Shortcomings of Perl under DOS + +Perl under DOS lacks some features of perl under UNIX because of +deficiencies in the UNIX-emulation, most notably: + +=over 4 + +=item * + +fork() and pipe() + +=item * + +some features of the UNIX filesystem regarding link count and file dates + +=item * + +in-place operation is a little bit broken with short filenames + +=item * + +sockets + +=back + +=head2 Building + +=over 4 + +=item * + +Unpack the source package F<perl5.6*.tar.gz> with djtarx. If you want +to use long file names under w95 and also to get Perl to pass all its +tests, don't forget to use + + set LFN=y + set FNCASE=y + +before unpacking the archive. + +=item * + +Create a "symlink" or copy your bash.exe to sh.exe in your C<($DJDIR)/bin> +directory. + + ln -s bash.exe sh.exe + +And make the C<SHELL> environment variable point to this F<sh.exe>: + + set SHELL=c:/djgpp/bin/sh.exe (use full path name!) + +You can do this in F<djgpp.env> too. Add this line BEFORE any section +definition: + + +SHELL=%DJDIR%/bin/sh.exe + +=item * + +If you have F<split.exe> and F<gsplit.exe> in your path, then rename +F<split.exe> to F<djsplit.exe>, and F<gsplit.exe> to F<split.exe>. +Copy or link F<gecho.exe> to F<echo.exe> if you don't have F<echo.exe>. +Copy or link F<gawk.exe> to F<awk.exe> if you don't have F<awk.exe>. + +=item * + +Chdir to the djgpp subdirectory of perl toplevel and type the following +command: + + configure.bat + +This will do some preprocessing then run the Configure script for you. +The Configure script is interactive, but in most cases you +just need to press ENTER. + +If the script says that your package is incomplete, and asks 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 F<cc1.exe> is at least 512kbyte (you can check this +with: C<stubedit cc1.exe>). + +You can use the Configure script in non-interactive mode too. +When I built my F<perl.exe>, I used something like this: + + configure.bat -des + +You can find more info about Configure's command line switches in +the F<INSTALL> file. + +When the script ends, and you want to change some values in the +generated F<config.sh> file, then run + + sh Configure -S + +after you made your modifications. + +IMPORTANT: if you use this C<-S> switch, be sure to delete the CONFIG +environment variable before running the script: + + set CONFIG= + +=item * + +Now you can compile Perl. Type: + + make + +=back + +=head2 Testing + +Type: + + make test + +If you're lucky you should see "All tests successful". But there can be +a few failed subtests (less than 5 hopefully) depending on some external +conditions (e.g. some subtests fail under linux/dosemu or plain dos +with short filenames only). + +=head2 Installation + +Type: + + make install + +This will copy the newly compiled perl and libraries into your DJGPP +directory structure. Perl.exe and the utilities go into C<($DJDIR)/bin>, +and the library goes under C<($DJDIR)/lib/perl5>. The pod documentation +goes under C<($DJDIR)/lib/perl5/pod>. + +=head1 AUTHOR + +Laszlo Molnar, F<laszlo.molnar@eth.ericsson.se> + +=head1 SEE ALSO + +perl(1). + +=cut + |