File Coverage

blib/lib/Alien/GSL.pm
Criterion Covered Total %
statement 11 11 100.0
branch n/a
condition n/a
subroutine 4 4 100.0
pod n/a
total 15 15 100.0


line stmt bran cond sub pod time code
1             package Alien::GSL;
2              
3 2     2   524799 use strict;
  2         12  
  2         59  
4 2     2   10 use warnings;
  2         9  
  2         44  
5 2     2   49 use 5.008001;
  2         7  
6              
7             our $VERSION = '1.07';
8              
9 2     2   12 use base 'Alien::Base';
  2         13  
  2         1230  
10              
11             1;
12              
13             =head1 NAME
14              
15             Alien::GSL - Easy installation of the GSL library
16              
17             =head1 SYNOPSIS
18              
19             # Build.PL
20             use Alien::GSL;
21             use Module::Build 0.28; # need at least 0.28
22              
23             my $builder = Module::Build->new(
24             configure_requires => {
25             'Alien::GSL' => '1.00', # first Alien::Base-based release
26             },
27             ...
28             extra_compiler_flags => Alien::GSL->cflags,
29             extra_linker_flags => Alien::GSL->libs,
30             ...
31             );
32              
33             $builder->create_build_script;
34              
35              
36             # lib/MyLibrary/GSL.pm
37             package MyLibrary::GSL;
38              
39             use Alien::GSL; # dynaload gsl
40              
41             ...
42              
43             =head1 DESCRIPTION
44              
45             Provides the Gnu Scientific Library (GSL) for use by Perl modules, installing it if necessary.
46             This module relies heavily on the L system to do so.
47             To avoid documentation skew, the author asks the reader to learn about the capabilities provided by that module rather than repeating them here.
48              
49             =head1 COMPATIBILITY
50              
51             Since version 1.00, L relies on L.
52             Releases before that version warned about alpha stability and therefore no compatibility has been provided.
53             There were no reverse dependencies on CPAN at the time of the change.
54              
55             From version 1.00, compability is provided by the L project itself which is quite concerned about keeping stability.
56             Future versions are expected to maintain compatibilty and failure to do so is to be considered a bug.
57             Of course this does not apply to the GSL library itself, though the author expects that the GNU project will provide the compatibility guarantees for that library as well.
58              
59             =head1 SEE ALSO
60              
61             =over
62              
63             =item *
64              
65             L
66              
67             =item *
68              
69             L
70              
71             =item *
72              
73             L
74              
75             =item *
76              
77             L
78              
79             =back
80              
81             =head1 SOURCE REPOSITORY
82              
83             L
84              
85             =head1 AUTHOR
86              
87             Joel Berger, Ejoel.a.berger@gmail.comE
88              
89             =head1 COPYRIGHT AND LICENSE
90              
91             Copyright (C) 2011-2015 by Joel Berger
92              
93             This library is free software; you can redistribute it and/or modify
94             it under the same terms as Perl itself.
95              
96