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