home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / vile-src.zip / vile-8.1 / doc / perl.doc < prev    next >
Text File  |  1998-05-27  |  2KB  |  45 lines
  1. -- $Header: /usr/build/vile/vile/doc/RCS/perl.doc,v 1.1 1998/05/27 10:14:29 bod Exp $
  2.  
  3. Perl Support 
  4. ------------ 
  5.  
  6. Vile supports the use of Perl as an extension language by embedding a 
  7. Perl interpreter into the editor. 
  8.  
  9. The `--with-perl' configure option enables Perl support at build time on 
  10. Unix hosts (for Win32 instructions see the help file). 
  11.  
  12. After the executable is successfully built, up to date documentation for 
  13. the API in various formats may be obtained from the following make 
  14. targets (not built by default): 
  15.  
  16.     vile-perl-api.doc 
  17.     vile-perl-api.man 
  18.     vile-perl-api.html     
  19.  
  20. A recent version of Perl is required.  The interface was developed and 
  21. tested using 5.004_04.  The most recent version of Perl may be retrieved 
  22. from the URL: 
  23.  
  24.     http://www.perl.com/CPAN/src/latest.tar.gz 
  25.  
  26. The Perl interpreter requires subsidiary files, the location of which is 
  27. coded into the Perl library.  As such, if a Perl-enabled Vile binary is 
  28. to be installed onto multiple machines, the same version of Perl must be 
  29. installed on each target machine, in the same location. 
  30.  
  31. This also means that if a newer version of Perl is installed, Vile must 
  32. either be rebuilt against the new version, or the version-specific 
  33. directory (given by `perl -V:archlib') of the old version must be 
  34. retained. 
  35.  
  36. Note also that embedding a Perl interpreter into Vile will increase the 
  37. size of the binary.  On many platforms, a shared Perl library may be 
  38. built which, at the cost of a load-time performance penalty, can 
  39. substantially reduce the size of the compiled vile, xvile, [nvi, apache, 
  40. etc, ...] and of course perl binaries. 
  41.  
  42. See also the output of `perl -V:useshrplib' and the section `Building a 
  43. shared libperl.so Perl library' in the `INSTALL' file from the Perl 
  44. distribution. 
  45.