Add built local::lib
[catagits/Gitalist.git] / local-lib5 / lib / perl5 / Module / Install / Philosophy.pod
1 =head1 NAME
2
3 Module::Install::Philosophy - The concepts behind Module::Install
4
5 =head1 SYNOPSIS
6
7 This document describes the personal philosophy behind the creation of
8 B<CPAN::MakeMaker> (the predecessor of B<Module::Install>).  The views
9 expressed here belong to Brian Ingerson; if they are not of interest to
10 you, you can safely ignore this document.
11
12 =head1 I HAVE A DREAM
13
14 I say to you today, my friends, that in spite of the difficulties and
15 frustrations of the moment, I still have a dream. It is a dream deeply
16 rooted in the Perl Module dream.
17
18 I have a dream that one day this community will rise up and live out the
19 true meaning of its creed: "We hold these truths to be self-evident:
20 that all Perl authors are created equal."
21
22 I have a dream that one day even the state of the C<CGI::> namespace, a
23 desert state, sweltering with the heat of injustice and oppression, will
24 be transformed into an oasis of freedom and justice.
25
26 I have a dream that my four modules will one day live in an archive
27 where they will not be judged by the number of their prerequisites but
28 by the content of their source code.
29
30 I have a dream today.
31
32 =head1 DESCRIPTION
33
34 The above is obviously a mutation of the monumental speech by great
35 Martin Luther King (L<http://web66.coled.umn.edu/new/MLK/MLK.html>).
36 While the contexts are vastly different, I feel that there are some
37 serious parallelisms.
38
39 The CPAN has become a place that is not free of injustice. This
40 situation has arisen not out of directed oppression, but from a failure
41 of our community to keep its tools sharp. It is the culmination of many
42 small decisions made in the name of practicality. This is a sad state
43 for an institution that was created to allow all interested people to
44 contribute equally to the best of their ability.
45
46 This assertion is rooted in my personal experience as an author. When I
47 created my first Perl module, Inline.pm, I knew that I had done
48 something important. But how was I to make a dent in vast Perl
49 community?
50
51 As a complete unknown in the Perl community, my voice did not travel
52 far. I repeatedly tried to get even an acknowledgment from the gurus
53 familiar with XS. No success. I resorted to sending messages with
54 ridiculous subjects to C<modules@perl.org>. 
55 (L<http://www.xray.mpe.mpg.de/mailing-lists/modules/2000-08/msg00078.html>) 
56 No response. Through sheer determination and shameless self-promotion I
57 eventually got the word out, and I hope the world is a slightly better
58 place for it.
59
60 Since then, Inline has won awards and I have had the privilege to meet almost
61 all of Perl's finest. But I still remember the pain of starting out, and
62 want to help invite more people into this wonderful world. 
63
64 One thing I have learned from experience is that the Perl community (and
65 throw in the Python and Ruby people as well) is a small drop in the vast
66 ocean of programming. It's a giant pot of Java out there; and a sea of
67 C. Perl may not be the biggest fish, but with some care and cunning we
68 could become a much bigger school.
69
70 These are the current problems that I see with CPAN and the core modules:
71
72 =over 4
73
74 =item * New Modules don't help Older Perls
75
76 If I were to guess what percent of all Perl5 installations were at the
77 current release level (5.8.0 in October 2002) I would say 3-5%. That may
78 even be generous. I'd say that over 40% of installations might still be
79 at 5.005 or earlier.
80
81 The biggest problem with adding a module to the core is that it only
82 helps a small subset of Perl users for a long long time. Worse yet, a
83 good module author will still probably avoid using the core additions as
84 prerequisites, because they want their new module to work as well on
85 5.005 as on 5.8.
86
87 CPAN::MakeMaker should be able to help in this regard. For example,
88 instead of putting Inline.pm into the core for 5.9, I can now
89 effectively get it into the core for every version of Perl that
90 Inline supports.
91
92 =item * Author Exclusiveness
93
94 Not just anybody can get a module into the core. It seems you have to
95 know people in high places. If I were a brilliant new talent with a
96 great new module, it would have a harder time getting the ear of the
97 pumpking, then if I were, say, Damian Conway. In fact, I probably
98 wouldn't even know where to start.
99
100 =item * Reduced Competition
101
102 One comment I've heard from some very good Perl programmers is
103 "Everything important has already been done". Their feeling is that
104 even though a module is suboptimal, it would be a waste of time to
105 write a competing module. Who would use it instead of the one already
106 in the core?
107
108 When I write a competing module, I know that I have to make it at least
109 twice as good as the existing one to even get noticed. That's not a bad
110 thing, but should everybody be forced into that situation?
111
112 For example, let's say that you have created a really useful CGI script.
113 Let's also say that it makes use of your own B<CGI::Special> module,
114 because B<CGI.pm> doesn't meet your needs. Even though your script might be
115 generally useful and worth sharing, the fact that it requires a
116 non-standard module can only negatively affect its acceptance. Trying to
117 get general acceptance for the superior B<CGI::Special> module will be
118 harder still.
119
120 Core modules are assumed by the general public to be "Best of Breed".
121 While this may be true for some modules at some point in time, it keeps
122 talented people from attempting to "breed" something better.
123
124 =item * Core Bloat
125
126 Every time we add a module to the core it gets bigger and bigger. And we
127 can't ever remove modules from the core, once they've been added.
128
129 If I had my druthers, we'd remove all modules from the core that weren't
130 necessary for either running Perl or installing modules. Of course, we'd
131 need to set things up so that installing modules was so easy, that it
132 could be done on the fly if necessary. Is this easily accomplishable?
133 Nope. Is it impossible? Nope. We have the best language in the world to
134 help us do it!
135
136 =item * Maintenance Bitrot
137
138 Believe it or not, Perl authors can sometimes acquire a "Life Beyond
139 Perl". They get families or new hobbies or even hit by a bus. (This
140 would be a "Death Beyond Perl".) The fact is, that once somebody writes
141 a piece of code and shares it with the world, they are expected to
142 maintain it for all time.
143
144 That is being generous. There are others that think that once their
145 module has become popular or made it into the core, they don't need to
146 keep fixing and improving it. I have personally been guilty of this sin.
147
148 And then there's the Damian Conway Effect. This plagues the exceptional
149 authors who are so innovative and prolific they simply don't have time
150 to maintain everything they have written.
151
152 =back
153
154 I initially formalized these opinions at the YAPC (Yet Another Perl
155 Conference) in June 2001. Since then I have been trying to think of
156 technological solutions to fix these social problems.
157
158 One idea was dubbed NAPC. NAPC is CPAN backwards. It is a large system
159 of precompiled modules that can be installed on the fly, with the goal
160 of reducing the number of modules in the core. NAPC hasn't got started
161 yet. I'd still like to do it someday, but it's a big problem with a lot
162 of issues.
163
164 B<CPAN::MakeMaker> (and now B<Module::Install>) on the other hand, is
165 simple and ultimately flexible.  It should work with all of the existing
166 CPAN processes without requiring any changes from them. And new features
167 can be continuously added. Even though it doesn't scratch all of my
168 philosophical CPAN itches, it's a good start.
169
170 =head1 CONCLUSION
171
172 This is all just food for thought. Take it with a pinch of salt. 
173
174 =head1 AUTHOR
175
176 Brian Ingerson E<lt>INGY@cpan.orgE<gt>
177
178 =head1 COPYRIGHT
179
180 Copyright (c) 2002. Brian Ingerson.
181
182 This document is free documentation; you can redistribute it and/or
183 modify it under the same terms as Perl itself.
184
185 See L<http://www.perl.com/perl/misc/Artistic.html>
186
187 =cut