File: perl.html

package info (click to toggle)
vile 9.8za-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 10,644 kB
  • sloc: ansic: 120,894; lex: 14,981; sh: 4,478; perl: 3,511; cpp: 3,180; makefile: 1,425; awk: 271
file content (84 lines) | stat: -rw-r--r-- 2,888 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
<!--
  $Id: perl.html,v 1.9 2019/04/13 17:06:26 tom Exp $
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">

<html>
<head>
  <meta name="generator" content=
  "HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">

  <title>Perl Support</title>
  <meta http-equiv="Content-Type" content=
  "text/html; charset=us-ascii">
  <link rel="author" href="mailto:dickey@invisible-island.net">
  <link rel="SHORTCUT ICON" href="/img/icons/vile.ico" type=
  "image/x-icon">
  <link rel="stylesheet" href="/css/simplestyle.css" type=
  "text/css">
</head>

<body>
  <hr>

  <p><a href="/">http://invisible-island.net/</a><a href=
  "/vile/">vile/</a><a href=
  "/vile/vile-toc.html">vile-toc</a><br></p>
  <hr>

  <h1 id="toplevel-toc"><a name="toplevel" id="toplevel">Perl
  Support</a></h1>

  <p>Vile supports the use of Perl as an extension language by
  embedding a Perl interpreter into the editor.</p>

  <p>The "--with-perl" configure option enables Perl support at
  build time on Unix hosts (for Win32 instructions see the file
  README.PC).</p>

  <p>After the executable is successfully built, up to date
  documentation for the API in various formats may be obtained from
  the following make targets (not built by default):</p>
  <pre>
    vile-perl-api.doc   (unix and win32)
    vile-perl-api.man   (unix hosts only)
    vile-perl-api.html  (unix hosts only)
</pre>

  <p>A recent version of Perl is required. The interface was
  developed and tested using 5.004_04. The most recent version of
  Perl may be retrieved from the URL:</p>
  <pre>
    <a href=
"http://www.perl.com/CPAN/src/latest.tar.gz">http://www.perl.com/CPAN/src/latest.tar.gz</a>
</pre>

  <p>The Perl interpreter requires subsidiary files, the location
  of which is coded into the Perl library. As such, if a
  Perl-enabled Vile binary is to be installed onto multiple
  machines, the same version of Perl must be installed on each
  target machine, in the same location.</p>

  <p>This also means that if a newer version of Perl is installed,
  Vile must either be rebuilt against the new version, or the
  version-specific directory (given by "perl -V:archlib") of the
  old version must be retained.</p>

  <p>Note also that embedding a Perl interpreter into Vile will
  increase the size of the binary. On many platforms, a shared Perl
  library may be built which, at the cost of a load-time
  performance penalty, can substantially reduce the size of the
  compiled vile, xvile, [nvi, apache, etc, ...] and of course perl
  binaries.</p>

  <p>See also the output of "perl -V:useshrplib" and the section
  "Building a shared libperl.so Perl library" in the "INSTALL" file
  from the Perl distribution.</p>

  <h2 id="credits-toc"><a name="credits" id=
  "credits">Credits</a></h2>

  <p>The Perl interface for vile was originally written by Kevin
  Buettner in 1997 and 1998.</p>
</body>
</html>