| 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 |