From 3ebf3d0324ea64a5b9b2a32595ae9a0b83248b75 Mon Sep 17 00:00:00 2001 From: Jarkko Hietaniemi Date: Thu, 26 Oct 2000 13:05:52 +0000 Subject: Undo #7451, this seems to be a deficiency in Perforce, there is no per-file line-terminator type, only per-client. p4raw-id: //depot/perl@7452 --- README.dos | 430 ++++++++++++++++++++++++++++++------------------------------- 1 file changed, 215 insertions(+), 215 deletions(-) (limited to 'README.dos') 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 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 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 environment variable point to this F: - - set SHELL=c:/djgpp/bin/sh.exe (use full path name!) - -You can do this in F too. Add this line BEFORE any section -definition: - - +SHELL=%DJDIR%/bin/sh.exe - -=item * - -If you have F and F in your path, then rename -F to F, and F to F. -Copy or link F to F if you don't have F. -Copy or link F to F if you don't have F. - -=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 is at least 512kbyte (you can check this -with: C). - -You can use the Configure script in non-interactive mode too. -When I built my F, I used something like this: - - configure.bat -des - -You can find more info about Configure's command line switches in -the F file. - -When the script ends, and you want to change some values in the -generated F 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 - -=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 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 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 environment variable point to this F: + + set SHELL=c:/djgpp/bin/sh.exe (use full path name!) + +You can do this in F too. Add this line BEFORE any section +definition: + + +SHELL=%DJDIR%/bin/sh.exe + +=item * + +If you have F and F in your path, then rename +F to F, and F to F. +Copy or link F to F if you don't have F. +Copy or link F to F if you don't have F. + +=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 is at least 512kbyte (you can check this +with: C). + +You can use the Configure script in non-interactive mode too. +When I built my F, I used something like this: + + configure.bat -des + +You can find more info about Configure's command line switches in +the F file. + +When the script ends, and you want to change some values in the +generated F 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 + +=head1 SEE ALSO + +perl(1). + +=cut + -- cgit v1.2.1