home *** CD-ROM | disk | FTP | other *** search
/ PC World 2000 September / PCWorld_2000-09_cd.bin / Komunik / sambar / _setup.1 / ABOUT.TXT < prev    next >
Text File  |  1998-01-10  |  11KB  |  259 lines
  1. Welcome to the binary distribution of Perl for the Win32 platform.
  2. This distribution has been compiled using the Borland C++ compiler
  3. (version 5.02).  It is built around the latest production release of
  4. Perl, version 5.004_02, which comes with Win32 support.
  5.  
  6. Please note that this distribution is not to be confused with
  7. the pre-5.004 Perl port by the Activeware folks, or the binaries
  8. they distribute (which are mostly referred to by "build" numbers).
  9.  
  10. This bundle contains almost everything you will need for using Perl
  11. on Win32 platforms.  It also contains everything needed to build,
  12. test and install additional perl modules from CPAN that you may not
  13. find in here, provided they use the standard MakeMaker extension
  14. build tools.  Since MakeMaker needs a `make' utility, a Win32 binary
  15. of Dennis Vadura's `dmake' tool is supplied (see below for more on
  16. `dmake').  For using this distribution to build extensions that need
  17. a C compiler, you will also need either Borland C++ 5.02, or Visual
  18. C++ (version 2.0 and later).
  19.  
  20.  
  21. WHY WOULD YOU WANT THIS?
  22. ------------------------
  23.  
  24.   + You want to use perl on WindowsNT or Windows95, but you have
  25.     no C compiler (or at least not one that will build perl).
  26.  
  27.   + You seem to have the compiler stuff, but not the patience or
  28.     knowledge to deal with compiling perl and the various extensions.
  29.     And you are happy to continue using the binary distributions that
  30.     you know people are going to keep putting out once every half
  31.     moon. [May not be exactly every half moon, but you'll keep the
  32.     faith.  Remember to give away that compiler you don't use :)]
  33.  
  34.   + You have one of the supported compilers that will build Perl,
  35.     but you want to jump-start your XSsively hardcore perl module
  36.     development by taking this shortcut.  [But see the notes below
  37.     on `USING IT WITH YOUR C COMPILER' for some caveats about doing
  38.     this.]
  39.  
  40.   + You want a perl that is capable of doing sockets on Windows95,
  41.     and you just have Visual C++. [The Visual C++ libraries known to
  42.     date have a problem with sockets on Windows95, which might cause
  43.     you trouble.  The Borland libraries, which this distribution was
  44.     built with, do not have the problem.]
  45.  
  46.  
  47. INSTALLATION
  48. ------------
  49.  
  50. To install:
  51.  
  52.    * Extract the archive so that the directory structure of the
  53.      files is preserved.
  54.  
  55.    * `cd' to the top level directory.
  56.  
  57.    * Type `install' (if in the command shell) or click on
  58.      `install.bat' (from the Explorer).  If that refuses to run for
  59.      some reason, you can instead type `perl\bin\perl install.bat'
  60.      in the command shell.  The setup process will ask a few
  61.      questions and will offer to generate HTML documentation from
  62.      the various files in the distribution.  A full installation
  63.      requires about 20 megabytes of free space.
  64.  
  65.    * Add the installed location of PERL.EXE to your `PATH'.
  66.      For instance, if you asked for things to be installed under
  67.      `e:\perl', add `e:\perl\bin' to your PATH.
  68.  
  69.    * You will need to edit the contents of %NetConfig in
  70.      `lib\site\Net\Config.pm' to set the names of the servers
  71.      used by the libnet package.
  72.  
  73.  
  74. PLATFORMS
  75. ---------
  76.  
  77. This binary distribution has been extensively tested only on WindowsNT.
  78. Based on reports from others, I believe it also works on Windows95,
  79. but I personally did not test it on that platform.  Note the supplied
  80. binaries are for the x86 architecture.
  81.  
  82.  
  83. WHAT IT CONTAINS
  84. ----------------
  85.  
  86. It includes the following packages:
  87.  
  88.     perl5.004_02
  89.     dmake-4.1
  90.  
  91.     Alias-2.3
  92.     Bit-Vector-4.2
  93.     Curses-1.01                          [*]
  94.     Data-Dumper-2.07
  95.     DateCalc-3.2
  96.     DateManip-5.10
  97.     DBD-ODBC-0.16
  98.     DBI-0.89
  99.     Devel-Peek-0.83
  100.     Devel-Symdump-2.00
  101.     DProf-19970614                       [*]
  102.     GD-1.14                              [*]
  103.     libnet-1.0505                        [*]
  104.     libwin32-0.08
  105.     libwww-perl-5.11
  106.     MD5-1.7
  107.     MIME-Base64-2.03
  108.     MLDBM-1.23
  109.     Storable-0.5                         [*]
  110.     String-Approx-2.1
  111.     Tk402.002
  112.  
  113. NOTES:
  114.  
  115. [*] These packages needed porting or other fixes to compile and
  116.     run properly.  All changes are included in the form of patches
  117.     (the kind that can be applied using the GNU patch utility) in
  118.     the `patches' subdirectory.  The full sources of all of
  119.     these packages (with the exception of dmake, see below for that)
  120.     can be found on the Comprehensive Perl Archive Network (CPAN).
  121.     Point your web browser at "http://www.perl.com/CPAN" to find the
  122.     CPAN site nearest you.
  123.  
  124. The package subdirectories under `distfiles' also contain other
  125. documentation and testsuites that came with the package.  These are
  126. not installed, so you may want to save them for later reference.
  127.  
  128. Please note that the patches are for information purposes only.
  129. You don't have to apply them (or even know what a patch is) to use
  130. this distribution.
  131.  
  132. In case you find yourself needing to build things from source, there
  133. is a win32 port of GNU patch-2.1 at:
  134.    http://www-personal.umich.edu/~gsar/patch2_1-win32.tar.gz
  135. that can be used to apply the included patches.
  136.  
  137. The modules in the distribution doubtless reflect my own personal
  138. pattern of use.  In some cases, I made a conscious decision not to
  139. include modules that don't contain C or XS source, since it should be
  140. possible to obtain, build and install such modules from CPAN without
  141. too much trouble (or a C compiler), using perl and `dmake'.
  142. Nevertheless, I shall add specific modules to the distribution if
  143. there is demand.
  144.  
  145.  
  146. DEMOS
  147. -----
  148.  
  149. After you install the distribution and add its location to your PATH,
  150. you can run the `widget' demo to check if your installed perl is
  151. working properly.  To make sure your new PATH setting takes effect,
  152. you may have to reboot.  Afterward, just type `widget' in the command
  153. shell, or double-click on `widget.bat' from the Explorer.
  154.  
  155.  
  156. DOCUMENTATION
  157. -------------
  158.  
  159. If you choose, the installation process converts all the Plain Old
  160. Documentation it can find into HTML pages.  There are normally stored
  161. in the `html' subdirectory under the install location.  You can start
  162. browsing the main perl documentation at `html/lib/pod/perl.html'.
  163.  
  164. If you choose not to install HTML, you can still browse almost
  165. all of the perl documentation from the command line using `perldoc'.
  166. Type `perldoc perldoc' to get started.
  167.  
  168. The `distfiles' area of the distribution also contains much HTML
  169. documentation that is not handled by the install process.  You
  170. may want to selectively copy parts of it to wherever you normally
  171. install your web documents.
  172.  
  173.  
  174. USING IT WITH YOUR C COMPILER
  175. -----------------------------
  176.  
  177. If you don't have a supported C compiler, this section doesn't
  178. apply to you.  If you have one, and intend using it to build
  179. other modules that require a C compiler, then read on.
  180.  
  181. This distribution was compiled with Borland C++ 5.02, using `dmake'.
  182. If you too have that compiler (or a later version), there are
  183. no caveats about using this distribution for further builds of
  184. extensions.  (I have heard earlier versions of Borland C++ have
  185. a buggy linker that doesn't like the module definition files that
  186. perl generates, so your mileage may vary if you're using
  187. versions earlier than 5.02.)
  188.  
  189. If you don't have the Borland compiler, it is also possible to build
  190. and use extension binaries compiled with Visual C++.  The converse--
  191. using a perl binary built under Visual C++ with extension binaries
  192. built under Borland C++--does not work due to a bug in the Visual
  193. C++ linker (present as of version 5.0).  In other words, if you have
  194. the Visual C++ compiler *and* you plan to use some pre-built
  195. extensions in this distribution *and* compile some of your own using
  196. the Visual C++ compiler, you will need the perl binaries that came
  197. with this distribution.  So don't overwrite the perl binary with
  198. one that you may have built yourself using the Visual C++ compiler.
  199.  
  200. The setup procedure will do the necessary things to make sure the
  201. installed version of the `lib\Config.pm' file will work with your
  202. compiler for future extension builds.
  203.  
  204.  
  205. TERMS OF USE
  206. ------------
  207.  
  208. Perl can be freely distributed under the `Artistic License' or the
  209. `GNU General Public Licence', described in the two files `Artistic'
  210. and `Copying' respectively.  Most of the modules have statements to
  211. the effect that they can be distributed under the same terms as Perl,
  212. but you should download and check the individual module's sources to
  213. be sure.
  214.  
  215. The included dmake tool is compiled from the latest public release of
  216. dmake-4.1 available from `ftp://plg.uwaterloo.ca/pub/dmake/'.  The
  217. binary is completely unsupported.  Full (commercial) support for dmake
  218. may be obtained from its author.  See `http://dmake.wticorp.com/' for
  219. the latest.  Note that public version of dmake-4.1 can only be
  220. distributed under the GNU General Public Licence.
  221.  
  222. The remaining parts of this binary distribution itself can be
  223. distributed under the same terms as Perl.  Beware that it is provided
  224. "as is", and comes with absolutely no warranty of any kind, either
  225. express or implied.  If you use the contents of this distribution, you
  226. do so at your own risk, and you agree to free the author(s) of any
  227. consequences arising from such use, either intended or otherwise.
  228.  
  229.  
  230. BEING NICE TO NICE BEINGS
  231. -------------------------
  232.  
  233. Perl is the creation of Larry Wall.  Continuing refinement of Perl
  234. is made possible by the unceasing efforts of many fine folk who have
  235. banded together with Larry in endless perlesque banter, collectively
  236. calling themselves "The Perl Porters".  If you find perl useful
  237. in getting your job done, you may want to drop them a note of
  238. appreciation at <perl-thanks@perl.org>.  Be sure to recount
  239. any war stories about how Perl helped you win your battles :)
  240.  
  241. Another fine way to encourage development of perl is to become a
  242. member of The Perl Institute, a non-profit organization which helps
  243. "people help Perl help people" (or something like that).  See
  244. http://www.perl.org/ for details.
  245.  
  246. If you plan to put this on a CDROM or other similar media, I request
  247. that you send me a brief message.  Note that some modules explicitly
  248. require that you obtain permission from the module author to do that
  249. sort of thing, so you should.  Altered versions of this distribution
  250. must be clearly marked as such.
  251.  
  252. Enjoy!
  253.  
  254.  
  255. Gurusamy Sarathy (Just Another Perl Porter)
  256. gsar@umich.edu
  257. 08-AUG-1997
  258.  
  259.