home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / perl560.zip / README.dos < prev    next >
Text File  |  2000-03-22  |  6KB  |  214 lines
  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, don't forget to use
  104.  
  105.         set LFN=y
  106.  
  107. before unpacking the archive.
  108.  
  109. =item *
  110.  
  111. Create a "symlink" or copy your bash.exe to sh.exe in your C<($DJDIR)/bin>
  112. directory.
  113.  
  114.         ln -s bash.exe sh.exe
  115.  
  116. And make the C<SHELL> environment variable point to this F<sh.exe>:
  117.  
  118.         set SHELL=c:/djgpp/bin/sh.exe (use full path name!)
  119.  
  120. You can do this in F<djgpp.env> too. Add this line BEFORE any section
  121. definition:
  122.  
  123.         +SHELL=%DJDIR%/bin/sh.exe
  124.  
  125. =item *
  126.  
  127. If you have F<split.exe> and F<gsplit.exe> in your path, then rename 
  128. F<split.exe> to F<djsplit.exe>, and F<gsplit.exe> to F<split.exe>.
  129. Copy or link F<gecho.exe> to F<echo.exe> if you don't have F<echo.exe>.
  130. Copy or link F<gawk.exe> to F<awk.exe> if you don't have F<awk.exe>.
  131.  
  132. =item *
  133.  
  134. Chdir to the djgpp subdirectory of perl toplevel and type the following
  135. command:
  136.  
  137.         configure.bat
  138.  
  139. This will do some preprocessing then run the Configure script for you.
  140. The Configure script is interactive, but in most cases you
  141. just need to press ENTER.
  142.  
  143. If the script says that your package is incomplete, and asks whether
  144. to continue, just answer with Y (this can only happen if you don't use
  145. long filenames).
  146.  
  147. When Configure asks about the extensions, I suggest IO and Fcntl,
  148. and if you want database handling then SDBM_File or GDBM_File
  149. (you need to install gdbm for this one). If you want to use the
  150. POSIX extension (this is the default), make sure that the stack
  151. size of your F<cc1.exe> is at least 512kbyte (you can check this
  152. with: C<stubedit cc1.exe>).
  153.  
  154. You can use the Configure script in non-interactive mode too.
  155. When I built my F<perl.exe>, I used something like this:
  156.  
  157.         configure.bat -des
  158.  
  159. You can find more info about Configure's command line switches in
  160. the F<INSTALL> file.
  161.  
  162. When the script ends, and you want to change some values in the
  163. generated F<config.sh> file, then run
  164.  
  165.         sh Configure -S
  166.  
  167. after you made your modifications.
  168.  
  169. IMPORTANT: if you use this C<-S> switch, be sure to delete the CONFIG
  170. environment variable before running the script:
  171.  
  172.         set CONFIG=
  173.  
  174. =item *
  175.  
  176. Now you can compile Perl. Type:
  177.  
  178.         make
  179.  
  180. =back
  181.  
  182. =head2 Testing
  183.  
  184. Type:
  185.  
  186.         make test
  187.  
  188. If you're lucky you should see "All tests successful". But there can be
  189. a few failed subtests (less than 5 hopefully) depending on some external
  190. conditions (e.g. some subtests fail under linux/dosemu or plain dos
  191. with short filenames only).
  192.  
  193. =head2 Installation
  194.  
  195. Type:
  196.  
  197.         make install
  198.  
  199. This will copy the newly compiled perl and libraries into your DJGPP
  200. directory structure. Perl.exe and the utilities go into C<($DJDIR)/bin>,
  201. and the library goes under C<($DJDIR)/lib/perl5>. The pod documentation
  202. goes under C<($DJDIR)/lib/perl5/pod>.
  203.  
  204. =head1 AUTHOR
  205.  
  206. Laszlo Molnar, F<laszlo.molnar@eth.ericsson.se>
  207.  
  208. =head1 SEE ALSO
  209.  
  210. perl(1).
  211.  
  212. =cut
  213.  
  214.