Commit | Line | Data |
---|---|---|
86530b38 AT |
1 | =head1 NAME |
2 | ||
3 | Inline-Support - Support Information for Inline.pm and related modules. | |
4 | ||
5 | =head1 DESCRIPTION | |
6 | ||
7 | This document contains all of the latest support information for | |
8 | C<Inline.pm> and the recognized Inline Language Support Modules (ILSMs) | |
9 | available on CPAN. | |
10 | ||
11 | =head1 SUPPORTED LANGUAGES | |
12 | ||
13 | The most important language that Inline supports is C<C>. That is | |
14 | because Perl itself is written in C<C>. By giving a your Perl scripts | |
15 | access to C<C>, you in effect give them access to the entire glorious | |
16 | internals of Perl. (Caveat scriptor :-) | |
17 | ||
18 | As of this writing, Inline also supports: | |
19 | ||
20 | - C++ | |
21 | - Java | |
22 | - Python | |
23 | - Tcl | |
24 | - Assembly | |
25 | - CPR | |
26 | - And even Inline::Foo! :) | |
27 | ||
28 | Projects that I would most like to see happen in the year 2001 are: | |
29 | ||
30 | - Fortran | |
31 | - Ruby | |
32 | - Lisp | |
33 | - Guile | |
34 | - Bash | |
35 | - Perl4 | |
36 | ||
37 | =head1 SUPPORTED PLATFORMS | |
38 | ||
39 | C<Inline::C> should work anywhere that CPAN extension modules (those | |
40 | that use XS) can be installed, using the typical install format of: | |
41 | ||
42 | perl Makefile.PL | |
43 | make | |
44 | make test | |
45 | make install | |
46 | ||
47 | It has been tested on many Unix and Windows variants. | |
48 | ||
49 | B<NOTE>: C<Inline::C> requires Perl 5.005 or higher because | |
50 | C<Parse::RecDescent> requires it. (Something to do with the C<qr> | |
51 | operator) | |
52 | ||
53 | Inline has been successfully tested at one time or another on the | |
54 | following platforms: | |
55 | ||
56 | Linux | |
57 | Solaris | |
58 | SunOS | |
59 | HPUX | |
60 | AIX | |
61 | FreeBSD | |
62 | OpenBSD | |
63 | BeOS | |
64 | OS X | |
65 | WinNT | |
66 | Win2K | |
67 | WinME | |
68 | Win98 | |
69 | Cygwin | |
70 | ||
71 | The Microsoft tests deserve a little more explanation. I used the following: | |
72 | ||
73 | Windows NT 4.0 (service pack 6) | |
74 | Perl 5.005_03 (ActiveState build 522) | |
75 | MS Visual C++ 6.0 | |
76 | The "nmake" make utility (distributed w/ Visual C++) | |
77 | ||
78 | C<Inline::C> pulls all of its base configuration (including which | |
79 | C<make> utility to use) from C<Config.pm>. Since your MSWin32 version of | |
80 | Perl probably came from ActiveState (as a binary distribution) the | |
81 | C<Config.pm> will indicate that C<nmake> is the system's C<make> | |
82 | utility. That is because ActiveState uses Visual C++ to compile Perl. | |
83 | ||
84 | To install C<Inline.pm> (or any other CPAN module) on MSWin32 w/ Visual | |
85 | C++, use these: | |
86 | ||
87 | perl Makefile.PL | |
88 | nmake | |
89 | nmake test | |
90 | nmake install | |
91 | ||
92 | Inline has also been made to work with Mingw32/gcc on all Windows | |
93 | platforms. This is a free compiler for Windows. You must also use a perl | |
94 | built with that compiler. | |
95 | ||
96 | The "Cygwin" test was done on a Windows 98 machine using the Cygwin | |
97 | Unix/Win32 porting layer software from Cygnus. The C<perl> binary on | |
98 | this machine was also compiled using the Cygwin tool set (C<gcc>). This | |
99 | software is freely available from http://sources.redhat.com/cygwin/ | |
100 | ||
101 | If you get Inline to work on a new platform, please send me email email. | |
102 | If it doesn't work, let me know as well and I'll see what can be done. | |
103 | ||
104 | =head1 SEE ALSO | |
105 | ||
106 | For general information about Inline see L<Inline>. | |
107 | ||
108 | For information about using Inline with C see L<Inline::C>. | |
109 | ||
110 | For sample programs using Inline with C see L<Inline::C-Cookbook>. | |
111 | ||
112 | For information on writing your own Inline Language Support Module, see | |
113 | L<Inline-API>. | |
114 | ||
115 | Inline's mailing list is inline@perl.org | |
116 | ||
117 | To subscribe, send email to inline-subscribe@perl.org | |
118 | ||
119 | =head1 AUTHOR | |
120 | ||
121 | Brian Ingerson <INGY@cpan.org> | |
122 | ||
123 | =head1 COPYRIGHT | |
124 | ||
125 | Copyright (c) 2000, 2001, 2002. Brian Ingerson. All rights reserved. | |
126 | ||
127 | This program is free software; you can redistribute it and/or modify it | |
128 | under the same terms as Perl itself. | |
129 | ||
130 | See http://www.perl.com/perl/misc/Artistic.html | |
131 | ||
132 | =cut |