File: Inline-Support.pod

package info (click to toggle)
libinline-perl 0.43-3
  • links: PTS
  • area: main
  • in suites: woody
  • size: 412 kB
  • ctags: 107
  • sloc: perl: 3,584; makefile: 42
file content (110 lines) | stat: -rw-r--r-- 3,421 bytes parent folder | download
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
=head1 NAME

Inline-Support - Support Information for Inline.pm and related modules.

=head1 DESCRIPTION

This document contains all of the latest support information for C<Inline.pm> and the recognized Inline Language Support Modules (ILSMs) available on CPAN.

=head1 SUPPORTED LANGUAGES

The most important language that Inline supports is C<C>. That is because Perl itself is written in C<C>. By giving a your Perl scripts access to C<C>, you in effect give them access to the entire glorious internals of Perl. (Caveat scriptor :-)

As of this writing, Inline also supports:

 - C++
 - Java
 - Python
 - Tcl
 - Assembly
 - CPR
 - And even Inline::Foo! :)

Projects that I would most like to see happen in the year 2001 are:

 - Fortran
 - Ruby
 - Lisp
 - Guile
 - Bash
 - Perl4

=head1 SUPPORTED PLATFORMS

C<Inline::C> should work anywhere that CPAN extension modules (those that use XS) can be installed, using the typical install format of:

    perl Makefile.PL
    make
    make test
    make install

It has been tested on many Unix and Windows variants.

B<NOTE>: C<Inline::C> requires Perl 5.005 or higher because C<Parse::RecDescent> requires it. (Something to do with the C<qr> operator)

Inline has been successfully tested at one time or another on the following platforms:

    Linux
    Solaris
    SunOS
    HPUX
    AIX
    FreeBSD
    OpenBSD
    BeOS
    OS X
    WinNT
    Win2K
    WinME
    Win98
    Cygwin

The Microsoft tests deserve a little more explanation. I used the following:

 Windows NT 4.0 (service pack 6)
 Perl 5.005_03 (ActiveState build 522)
 MS Visual C++ 6.0
 The "nmake" make utility (distributed w/ Visual C++)

C<Inline::C> pulls all of its base configuration (including which C<make> utility to use) from C<Config.pm>. Since your MSWin32 version of Perl probably came from ActiveState (as a binary distribution) the C<Config.pm> will indicate that C<nmake> is the system's C<make> utility. That is because ActiveState uses Visual C++ to compile Perl.

To install C<Inline.pm> (or any other CPAN module) on MSWin32 w/ Visual C++, use these:

    perl Makefile.PL
    nmake
    nmake test
    nmake install

Inline has also been made to work with Mingw32/gcc on all Windows platforms. This is a free compiler for Windows. You must also use a perl built with that compiler.

The "Cygwin" test was done on a Windows 98 machine using the Cygwin Unix/Win32 porting layer software from Cygnus. The C<perl> binary on this machine was also compiled using the Cygwin tool set (C<gcc>). This software is freely available from http://sources.redhat.com/cygwin/

If you get Inline to work on a new platform, please send me email email. If it doesn't work, let me know as well and I'll see what can be done.

=head1 SEE ALSO

For general information about Inline see L<Inline>.

For information about using Inline with C see L<Inline::C>.

For sample programs using Inline with C see L<Inline::C-Cookbook>.

For information on writing your own Inline Language Support Module, see L<Inline-API>.

Inline's mailing list is inline@perl.org

To subscribe, send email to inline-subscribe@perl.org

=head1 AUTHOR

Brian Ingerson <INGY@cpan.org>

=head1 COPYRIGHT

Copyright (c) 2000, 2001. Brian Ingerson. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html

=cut