README.dos

   1 If you read this file _as_is_, just ignore the funny characters you
   2 see. It is written in the POD format (see perlpod manpage) which is
   3 specially designed to be readable as is.
   4
   5 =head1 NAME
   6
   7 perldos - Perl under DOS, W31, W95.
   8
   9 =head1 SYNOPSIS
  10
  11 These are instructions for building Perl under DOS (or w??), using
  12 DJGPP v2.01 or later. Under w95 long filenames are supported.
  13
  14 =head1 DESCRIPTION
  15
  16 Before you start, you should glance through the README file
  17 found in the top-level directory where the Perl distribution
  18 was extracted.  Make sure you read and understand the terms under
  19 which this software is being distributed.
  20
  21 This port currently supports MakeMaker (the set of modules that
  22 is used to build extensions to perl).  Therefore, you should be
  23 able to build and install most extensions found in the CPAN sites.
  24
  25 =head2 Prerequisites
  26
  27 =over 4
  28
  29 =item DJGPP
  30
  31 DJGPP is a port of GNU C/C++ compiler and development tools to 32-bit,
  32 protected-mode environment on Intel 32-bit CPUs running MS-DOS and compatible
  33 operating systems, by DJ Delorie <dj@delorie.com> and friends.
  34
  35 For more details (FAQ), check out the home of DJGPP at:
  36
  37         http://www.delorie.com/djgpp/
  38
  39 If you have questions about DJGPP, try posting to the DJGPP newsgroup:
  40 comp.os.msdos.djgpp, or use the email gateway djgpp@delorie.com.
  41
  42 You can find the full DJGPP distribution on any SimTel.Net mirror all over
  43 the world. Like:
  44
  45         ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2*
  46
  47 You need the following files to build perl (or add new modules):
  48
  49         v2/djdev202.zip
  50         v2/bnu27b.zip
  51         v2gnu/gcc2721b.zip
  52         v2gnu/bsh1147b.zip
  53         v2gnu/mak3761b.zip
  54         v2gnu/fil316b.zip
  55         v2gnu/sed118b.zip
  56         v2gnu/txt122b.zip
  57         v2gnu/dif271b.zip
  58         v2gnu/grep21b.zip
  59         v2gnu/shl112b.zip
  60         v2gnu/gawk303b.zip
  61         v2misc/csdpmi4b.zip
  62
  63 or possibly any newer version.
  64
  65 =item Pthreads
  66
  67 Thread support is not tested in this version of the djgpp perl.
  68
  69 =back
  70
  71 =head2 Shortcomings of Perl under DOS
  72
  73 Perl under DOS lacks some features of perl under UNIX because of
  74 deficiencies in the UNIX-emulation, most notably:
  75
  76 =over 4
  77
  78 =item *
  79
  80 fork() and pipe()
  81
  82 =item *
  83
  84 some features of the UNIX filesystem regarding link count and file dates
  85
  86 =item *
  87
  88 in-place operation is a little bit broken with short filenames
  89
  90 =item *
  91
  92 sockets
  93
  94 =back
  95
  96 =head2 Building
  97
  98 =over 4
  99
 100 =item *
 101
 102 Unpack the source package F<perl5.6*.tar.gz> with djtarx. If you want
 103 to use long file names under w95 and also to get Perl to pass all its
 104 tests, don't forget to use
 105
 106         set LFN=y
 107         set FNCASE=y
 108
 109 before unpacking the archive.
 110
 111 =item *
 112
 113 Create a "symlink" or copy your bash.exe to sh.exe in your C<($DJDIR)/bin>
 114 directory.
 115
 116         ln -s bash.exe sh.exe
 117
 118 And make the C<SHELL> environment variable point to this F<sh.exe>:
 119
 120         set SHELL=c:/djgpp/bin/sh.exe (use full path name!)
 121
 122 You can do this in F<djgpp.env> too. Add this line BEFORE any section
 123 definition:
 124
 125         +SHELL=%DJDIR%/bin/sh.exe
 126
 127 =item *
 128
 129 If you have F<split.exe> and F<gsplit.exe> in your path, then rename
 130 F<split.exe> to F<djsplit.exe>, and F<gsplit.exe> to F<split.exe>.
 131 Copy or link F<gecho.exe> to F<echo.exe> if you don't have F<echo.exe>.
 132 Copy or link F<gawk.exe> to F<awk.exe> if you don't have F<awk.exe>.
 133
 134 =item *
 135
 136 Chdir to the djgpp subdirectory of perl toplevel and type the following
 137 command:
 138
 139         configure.bat
 140
 141 This will do some preprocessing then run the Configure script for you.
 142 The Configure script is interactive, but in most cases you
 143 just need to press ENTER.
 144
 145 If the script says that your package is incomplete, and asks whether
 146 to continue, just answer with Y (this can only happen if you don't use
 147 long filenames).
 148
 149 When Configure asks about the extensions, I suggest IO and Fcntl,
 150 and if you want database handling then SDBM_File or GDBM_File
 151 (you need to install gdbm for this one). If you want to use the
 152 POSIX extension (this is the default), make sure that the stack
 153 size of your F<cc1.exe> is at least 512kbyte (you can check this
 154 with: C<stubedit cc1.exe>).
 155
 156 You can use the Configure script in non-interactive mode too.
 157 When I built my F<perl.exe>, I used something like this:
 158
 159         configure.bat -des
 160
 161 You can find more info about Configure's command line switches in
 162 the F<INSTALL> file.
 163
 164 When the script ends, and you want to change some values in the
 165 generated F<config.sh> file, then run
 166
 167         sh Configure -S
 168
 169 after you made your modifications.
 170
 171 IMPORTANT: if you use this C<-S> switch, be sure to delete the CONFIG
 172 environment variable before running the script:
 173
 174         set CONFIG=
 175
 176 =item *
 177
 178 Now you can compile Perl. Type:
 179
 180         make
 181
 182 =back
 183
 184 =head2 Testing
 185
 186 Type:
 187
 188         make test
 189
 190 If you're lucky you should see "All tests successful". But there can be
 191 a few failed subtests (less than 5 hopefully) depending on some external
 192 conditions (e.g. some subtests fail under linux/dosemu or plain dos
 193 with short filenames only).
 194
 195 =head2 Installation
 196
 197 Type:
 198
 199         make install
 200
 201 This will copy the newly compiled perl and libraries into your DJGPP
 202 directory structure. Perl.exe and the utilities go into C<($DJDIR)/bin>,
 203 and the library goes under C<($DJDIR)/lib/perl5>. The pod documentation
 204 goes under C<($DJDIR)/lib/perl5/pod>.
 205
 206 =head1 AUTHOR
 207
 208 Laszlo Molnar, F<laszlo.molnar@eth.ericsson.se>
 209
 210 =head1 SEE ALSO
 211
 212 perl(1).
 213
 214 =cut
 215