File: perlsource.html

package info (click to toggle)
perl-doc-html 5.26.0-4
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 39,400 kB
  • sloc: xml: 36; makefile: 7
file content (645 lines) | stat: -rw-r--r-- 23,741 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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <title>perlsource - perldoc.perl.org</title>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <meta http-equiv="Content-Language" content="en-gb">
  <link rel="search" type="application/opensearchdescription+xml" title="Search perldoc.perl.org" href="/static/search.xml"/>
  <link href="static/css-20100830.css" rel="stylesheet" rev="stylesheet" type="text/css" media="screen">
  <link href="static/exploreperl.css" rel="stylesheet" rev="stylesheet" type="text/css">
</head>

<body onLoad="perldoc.startup();" onPageShow="if (event.persisted) perldoc.startup();">
    <div id="page">
      
      <div id="header">
	<div id="homepage_link">
	  <a href="index.html"></a>
	</div>
	<div id="strapline">
	  Perl Programming Documentation
	</div>
	<div id="download_link" class="download">
	  <a href="http://www.perl.org/get.html">Download Perl</a>
	</div>
	<div id="explore_link" class="download">
	  <a id="explore_anchor" href="#">Explore</a>
	</div>
      </div>
      
      <div id="body">
        <div id="left_column">
          <div class="side_group">
            
	    <div class="side_panel doc_panel">
              <p>Manual</p>
              <ul>
                <li><a href="index-overview.html">Overview</a>
                <li><a href="index-tutorials.html">Tutorials</a>
                <li><a href="index-faq.html">FAQs</a>
                <li><a href="index-history.html">History / Changes</a>
                <li><a href="index-licence.html">License</a>
              </ul>
            </div>
            <div class="side_panel doc_panel">
              <p>Reference</p>
              <ul>
                <li><a href="index-language.html">Language</a>
                <li><a href="index-functions.html">Functions</a>
                <li><a href="perlop.html">Operators</a>
                <li><a href="perlvar.html">Special Variables</a>
                <li><a href="index-pragmas.html">Pragmas</a>
                <li><a href="index-utilities.html">Utilities</a>
                <li><a href="index-internals.html">Internals</a>
                <li><a href="index-platforms.html">Platform Specific</a>
              </ul>
            </div>
            <div class="side_panel doc_panel">
              <p>Modules</p>
              <ul>
		<li>
		
                
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		
                  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		
                  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		    
		  
		
                  
		
                  
		
                  
		    
		  
		
                  
		
                  
		
		
                    <a href="index-modules-A.html">A</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-B.html">B</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-C.html">C</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-D.html">D</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-E.html">E</a>
                    
                      
                        <li>
                      
                    
                
                    <a href="index-modules-F.html">F</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-G.html">G</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-H.html">H</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-I.html">I</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-L.html">L</a>
                    
                      
                        <li>
                      
                    
                
                    <a href="index-modules-M.html">M</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-N.html">N</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-O.html">O</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-P.html">P</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-S.html">S</a>
                    
                      
                        <li>
                      
                    
                
                    <a href="index-modules-T.html">T</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-U.html">U</a>
                    
                      
                        &bull;
                      
                    
                
                    <a href="index-modules-X.html">X</a>
                    
                
              </ul>
            </div>
            
	      <div class="side_panel doc_panel">
		<p>Tools</p>
		<ul>
		  <li><a href="preferences.html">Preferences</a>
		</ul>
	      </div>
            
          </div>
        </div>
        <div id="centre_column">
          <div id="content_header">
            <div id="title_bar">
              <div id="page_name">
                <h1>perlsource</h1>
              </div>
              <div id="perl_version">
                Perl 5 version 26.0 documentation
              </div>
              <div class="page_links" id="page_links_top">
                <a href="#" onClick="toolbar.goToTop();return false;">Go to top</a>
		
              </div>
	      <div class="page_links" id="page_links_bottom">
		
                  <a href="#" id="page_index_toggle">Show page index</a> &bull;
		
                <a href="#" id="recent_pages_toggle">Show recent pages</a>		
	      </div>
	      <div id="search_form">
		<form action="search.html" method="GET" id="search">
		  <input type="text" name="q" id="search_box" alt="Search">
		</form>
	      </div>
            </div>
            <div id="breadcrumbs">
                
    <a href="index.html">Home</a> &gt;
    
      
        <a href="index-internals.html">Internals and C language interface</a> &gt;
      
    
    perlsource
  

            </div>
          </div>
          <div id="content_body">
	    <!--[if lt IE 7]>
 <div class="noscript">
   <p>
     <strong>It looks like you're using Internet Explorer 6. This is a very old
     browser which does not offer full support for modern websites.</strong>
   </p>
   <p>
     Unfortunately this means that this website will not work on
     your computer.
   </p>
   <p>
     Don't miss out though! To view the site (and get a better experience from
     many other websites), simply upgrade to
     <a href="http://www.microsoft.com/windows/Internet-explorer/default.aspx">Internet
Explorer 8</a>
     or download an alternative browser such as
     <a href="http://www.mozilla.com/en-US/firefox/firefox.html">Firefox</a>,
     <a href="http://www.apple.com/safari/download/">Safari</a>, or
     <a href="http://www.google.co.uk/chrome">Google Chrome</a>.
   </p>
   <p>
     All of these browsers are free. If you're using a PC at work, you may
     need to contact your IT administrator.
   </p>
 </div>
<![endif]-->
	    <noscript>
	      <div class="noscript">
	      <p>
                <strong>Please note: Many features of this site require JavaScript. You appear to have JavaScript disabled,
	        or are running a non-JavaScript capable web browser.</strong>
	      </p>
	      <p>
		To get the best experience, please enable JavaScript or download a modern web browser such as <a href="http://www.microsoft.com/windows/Internet-explorer/default.aspx">Internet Explorer 8</a>, <a href="http://www.mozilla.com/en-US/firefox/firefox.html">Firefox</a>, <a href="http://www.apple.com/safari/download/">Safari</a>, or <a href="http://www.google.co.uk/chrome">Google Chrome</a>.
              </p>
	      </div>
	    </noscript>

	    <div id="recent_pages" class="hud_container">
	      <div id="recent_pages_header" class="hud_header">
		<div id="recent_pages_close" class="hud_close"><a href="#" onClick="recentPages.hide();return false;"></a></div>
		<div id="recent_pages_title" class="hud_title"><span class="hud_span_top">Recently read</span></div>
		<div id="recent_pages_topright" class="hud_topright"></div>
	      </div>
	      <div id="recent_pages_content" class="hud_content">
	      </div>
	      <div id="recent_pages_footer" class="hud_footer">
		<div id="recent_pages_bottomleft" class="hud_bottomleft"></div>
		<div id="recent_pages_bottom" class="hud_bottom"><span class="hud_span_bottom"></span></div>
		<div id="recent_pages_resize" class="hud_resize"></div>
	      </div>
	    </div>
  
	    <div id="from_search"></div>
            <h1>perlsource</h1>


  <!--    -->
<ul><li><a href="#NAME">NAME</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#FINDING-YOUR-WAY-AROUND">FINDING YOUR WAY AROUND</a><ul><li><a href="#C-code">C code</a><li><a href="#Core-modules">Core modules</a><li><a href="#Tests">Tests</a><li><a href="#Documentation">Documentation</a><li><a href="#Hacking-tools-and-documentation">Hacking tools and documentation</a><li><a href="#Build-system">Build system</a><li><a href="#_AUTHORS_">_AUTHORS_</a><li><a href="#_MANIFEST_">_MANIFEST_</a></ul></ul><a name="NAME"></a><h1>NAME</h1>
<p>perlsource - A guide to the Perl source tree</p>
<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>
<p>This document describes the layout of the Perl source tree. If you're
hacking on the Perl core, this will help you find what you're looking
for.</p>
<a name="FINDING-YOUR-WAY-AROUND"></a><h1>FINDING YOUR WAY AROUND</h1>
<p>The Perl source tree is big. Here's some of the thing you'll find in
it:</p>
<a name="C-code"></a><h2>C code</h2>
<p>The C source code and header files mostly live in the root of the
source tree. There are a few platform-specific directories which
contain C code. In addition, some of the modules shipped with Perl
include C or XS code.</p>
<p>See <a href="perlinterp.html">perlinterp</a> for more details on the files that make up the Perl
interpreter, as well as details on how it works.</p>
<a name="Core-modules"></a><h2>Core modules</h2>
<p>Modules shipped as part of the Perl core live in four subdirectories.
Two of these directories contain modules that live in the core, and two
contain modules that can also be released separately on CPAN. Modules
which can be released on cpan are known as "dual-life" modules.</p>
<ul>
<li><a name="*-_lib%2f_"></a><b><i>lib/</i></b>
<p>This directory contains pure-Perl modules which are only released as
part of the core. This directory contains <i>all</i> of the modules and
their tests, unlike other core modules.</p>
</li>
<li><a name="*-_ext%2f_"></a><b><i>ext/</i></b>
<p>Like <i>lib/</i>, this directory contains modules which are only released
as part of the core.  Unlike <i>lib/</i>, however, a module under <i>ext/</i>
generally has a CPAN-style directory- and file-layout and its own
<i>Makefile.PL</i>.  There is no expectation that a module under <i>ext/</i>
will work with earlier versions of Perl 5.  Hence, such a module may
take full advantage of syntactical and other improvements in Perl 5
blead.</p>
</li>
<li><a name="*-_dist%2f_"></a><b><i>dist/</i></b>
<p>This directory is for dual-life modules where the blead source is
canonical. Note that some modules in this directory may not yet have
been released separately on CPAN.  Modules under <i>dist/</i> should make
an effort to work with earlier versions of Perl 5.</p>
</li>
<li><a name="*-_cpan%2f_"></a><b><i>cpan/</i></b>
<p>This directory contains dual-life modules where the CPAN module is
canonical. Do not patch these modules directly! Changes to these
modules should be submitted to the maintainer of the CPAN module. Once
those changes are applied and released, the new version of the module
will be incorporated into the core.</p>
</li>
</ul>
<p>For some dual-life modules, it has not yet been determined if the CPAN
version or the blead source is canonical. Until that is done, those
modules should be in <i>cpan/</i>.</p>
<a name="Tests"></a><h2>Tests</h2>
<p>The Perl core has an extensive test suite. If you add new tests (or new
modules with tests), you may need to update the <i>t/TEST</i> file so that
the tests are run.</p>
<ul>
<li><a name="*-Module-tests"></a><b>Module tests</b>
<p>Tests for core modules in the <i>lib/</i> directory are right next to the
module itself. For example, we have <i>lib/strict.pm</i> and
<i>lib/strict.t</i>.</p>
<p>Tests for modules in <i>ext/</i> and the dual-life modules are in <i>t/</i>
subdirectories for each module, like a standard CPAN distribution.</p>
</li>
<li><a name="*-_t%2fbase%2f_"></a><b><i>t/base/</i></b>
<p>Tests for the absolute basic functionality of Perl. This includes
<code class="inline">if</code>
, basic file reads and writes, simple regexes, etc. These are run
first in the test suite and if any of them fail, something is <i>really</i>
broken.</p>
</li>
<li><a name="*-_t%2fcmd%2f_"></a><b><i>t/cmd/</i></b>
<p>Tests for basic control structures, <code class="inline">if</code>
/<code class="inline">else</code>
, <code class="inline">while</code>
, subroutines,
etc.</p>
</li>
<li><a name="*-_t%2fcomp%2f_"></a><b><i>t/comp/</i></b>
<p>Tests for basic issues of how Perl parses and compiles itself.</p>
</li>
<li><a name="*-_t%2fio%2f_"></a><b><i>t/io/</i></b>
<p>Tests for built-in IO functions, including command line arguments.</p>
</li>
<li><a name="*-_t%2fmro%2f_"></a><b><i>t/mro/</i></b>
<p>Tests for perl's method resolution order implementations (see <a href="mro.html">mro</a>).</p>
</li>
<li><a name="*-_t%2fop%2f_"></a><b><i>t/op/</i></b>
<p>Tests for perl's built in functions that don't fit into any of the
other directories.</p>
</li>
<li><a name="*-_t%2fopbasic%2f_"></a><b><i>t/opbasic/</i></b>
<p>Tests for perl's built in functions which, like those in <i>t/op/</i>, do
not fit into any of the other directories, but which, in addition,
cannot use <i>t/test.pl</i>,as that program depends on functionality which
the test file itself is testing.</p>
</li>
<li><a name="*-_t%2fre%2f_"></a><b><i>t/re/</i></b>
<p>Tests for regex related functions or behaviour. (These used to live in
t/op).</p>
</li>
<li><a name="*-_t%2frun%2f_"></a><b><i>t/run/</i></b>
<p>Tests for features of how perl actually runs, including exit codes and
handling of PERL* environment variables.</p>
</li>
<li><a name="*-_t%2funi%2f_"></a><b><i>t/uni/</i></b>
<p>Tests for the core support of Unicode.</p>
</li>
<li><a name="*-_t%2fwin32%2f_"></a><b><i>t/win32/</i></b>
<p>Windows-specific tests.</p>
</li>
<li><a name="*-_t%2fporting%2f_"></a><b><i>t/porting/</i></b>
<p>Tests the state of the source tree for various common errors. For
example, it tests that everyone who is listed in the git log has a
corresponding entry in the <i>AUTHORS</i> file.</p>
</li>
<li><a name="*-_t%2flib%2f_"></a><b><i>t/lib/</i></b>
<p>The old home for the module tests, you shouldn't put anything new in
here. There are still some bits and pieces hanging around in here that
need to be moved. Perhaps you could move them?  Thanks!</p>
</li>
</ul>
<a name="Documentation"></a><h2>Documentation</h2>
<p>All of the core documentation intended for end users lives in <i>pod/</i>.
Individual modules in <i>lib/</i>, <i>ext/</i>, <i>dist/</i>, and <i>cpan/</i> usually
have their own documentation, either in the <i>Module.pm</i> file or an
accompanying <i>Module.pod</i> file.</p>
<p>Finally, documentation intended for core Perl developers lives in the
<i>Porting/</i> directory.</p>
<a name="Hacking-tools-and-documentation"></a><h2>Hacking tools and documentation</h2>
<p>The <i>Porting</i> directory contains a grab bag of code and documentation
intended to help porters work on Perl. Some of the highlights include:</p>
<ul>
<li><a name="*-_check*_"></a><b><i>check*</i></b>
<p>These are scripts which will check the source things like ANSI C
violations, POD encoding issues, etc.</p>
</li>
<li><a name="*-_Maintainers_%2c-_Maintainers.pl_%2c-and-_Maintainers.pm_"></a><b><i>Maintainers</i>, <i>Maintainers.pl</i>, and <i>Maintainers.pm</i></b>
<p>These files contain information on who maintains which modules. Run
<code class="inline"><span class="w">perl</span> <span class="w">Porting</span>/<span class="w">Maintainers</span> -M <span class="w">Module::Name</span></code>
 to find out more
information about a dual-life module.</p>
</li>
<li><a name="*-_podtidy_"></a><b><i>podtidy</i></b>
<p>Tidies a pod file. It's a good idea to run this on a pod file you've
patched.</p>
</li>
</ul>
<a name="Build-system"></a><h2>Build system</h2>
<p>The Perl build system starts with the <i>Configure</i> script in the root
directory.</p>
<p>Platform-specific pieces of the build system also live in
platform-specific directories like <i>win32/</i>, <i>vms/</i>, etc.</p>
<p>The <i>Configure</i> script is ultimately responsible for generating a
<i>Makefile</i>.</p>
<p>The build system that Perl uses is called metaconfig. This system is
maintained separately from the Perl core.</p>
<p>The metaconfig system has its own git repository. Please see its README
file in <a href="http://perl5.git.perl.org/metaconfig.git/">http://perl5.git.perl.org/metaconfig.git/</a> for more details.</p>
<p>The <i>Cross</i> directory contains various files related to
cross-compiling Perl. See <i>Cross/README</i> for more details.</p>
<a name="_AUTHORS_"></a><h2><i>AUTHORS</i></h2>
<p>This file lists everyone who's contributed to Perl. If you submit a
patch, you should add your name to this file as part of the patch.</p>
<a name="_MANIFEST_"></a><h2><i>MANIFEST</i></h2>
<p>The <i>MANIFEST</i> file in the root of the source tree contains a list of
every file in the Perl core, as well as a brief description of each
file.</p>
<p>You can get an overview of all the files with this command:</p>
<pre class="verbatim"><ol><li>  <span class="i">% perl</span> -<span class="w">lne</span> <span class="q">&#39;print if /^[^\/]+\.[ch]\s+/&#39;</span> <span class="w">MANIFEST</span></li></ol></pre>



  <div id="page_index" class="hud_container">
    <div id="page_index_header" class="hud_header">
      <div id="page_index_close" class="hud_close"><a href="#" onClick="pageIndex.hide();return false;"></a></div>
      <div id="page_index_title" class="hud_title"><span class="hud_span_top">Page index</span></div>
      <div id="page_index_topright" class="hud_topright"></div>
    </div>
    <div id="page_index_content" class="hud_content">
      <ul><li><a href="#NAME">NAME</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#FINDING-YOUR-WAY-AROUND">FINDING YOUR WAY AROUND</a><ul><li><a href="#C-code">C code</a><li><a href="#Core-modules">Core modules</a><li><a href="#Tests">Tests</a><li><a href="#Documentation">Documentation</a><li><a href="#Hacking-tools-and-documentation">Hacking tools and documentation</a><li><a href="#Build-system">Build system</a><li><a href="#_AUTHORS_">_AUTHORS_</a><li><a href="#_MANIFEST_">_MANIFEST_</a></ul></ul>
    </div>
    <div id="page_index_footer" class="hud_footer">
      <div id="page_index_bottomleft" class="hud_bottomleft"></div>
      <div id="page_index_bottom" class="hud_bottom"><span class="hud_span_bottom"></span></div>
      <div id="page_index_resize" class="hud_resize"></div>
    </div>
  </div>


	    &nbsp;
          </div>
          <div id="content_footer">
          </div>
        </div>
        <div class="clear"></div>
      </div>
      
    <div id="footer">
      <div id="footer_content">
        <div id="footer_strapline">
          perldoc.perl.org - Official documentation for the Perl programming language
        </div>
        <div id="footer_links">
          <div id="address">
            <p class="name">Contact details</p>
            <p class="address">
	      Site maintained by <a href="mailto:jj@jonallen.info">Jon Allen (JJ)</a><br>
	    </p>
            <p class="contact">
              Documentation maintained by the <a href="http://lists.cpan.org/showlist.cgi?name=perl5-porters">Perl 5 Porters</a>
            </p>
          </div>
          <ul class="f1">
            <li>Manual
              <ul class="f2">
                <li><a href="index-overview.html">Overview</a>
                <li><a href="index-tutorials.html">Tutorials</a>
                <li><a href="index-faq.html">FAQs</a>
                <li><a href="index-history.html">Changes</a>
              </ul>
            <li>Reference
              <ul class="f2">
                <li><a href="index-language.html">Language</a>
                <li><a href="index-functions.html">Functions</a>
                <li><a href="perlop.html">Operators</a>
                <li><a href="perlvar.html">Variables</a>
              </ul>
            <li>Modules
              <ul class="f2">
                <li><a href="index-modules-A.html">Modules</a>
                <li><a href="index-pragmas.html">Pragmas</a>
                <li><a href="index-utilities.html">Utilities</a>
              </ul>
            <li>Misc
              <ul class="f2">
                <li><a href="index-licence.html">License</a>
                <li><a href="index-internals.html">Internals</a>
                <li><a href="index-platforms.html">Platforms</a>
              </ul>          </ul>
          <div class="clear"></div>
        </div>
      </div>
      <div id="footer_end">
      </div>
    </div>
      
    </div>
      <script language="JavaScript" type="text/javascript" src="static/exploreperl.js"></script>
      <script language="JavaScript" src="static/combined-20100403.js" type="text/javascript"></script>
<script language="JavaScript" type="text/javascript">
  perldoc.setPath(0);
  perldoc.pageName    = 'perlsource';
  perldoc.pageAddress = 'perlsource.html';
  perldoc.contentPage = 1;
  explorePerl.render();
  explorePerl.addEvents('explore_anchor');
</script>
    
  </body>
</html>