perlutil.html 25.5 KB
Newer Older
1 2 3
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
4 5
<head>
  <title>perlutil - perldoc.perl.org</title>
6 7
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <meta http-equiv="Content-Language" content="en-gb">
8 9 10
  <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">
11 12
</head>

13 14 15 16 17 18 19
<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>
20 21 22 23 24 25 26 27 28
	<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>
29
      </div>
30 31 32 33
      
      <div id="body">
        <div id="left_column">
          <div class="side_group">
34 35
            
	    <div class="side_panel doc_panel">
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
              <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>
54
                <li><a href="index-internals.html">Internals</a>
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
                <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>
277 278 279 280 281 282 283 284
            
	      <div class="side_panel doc_panel">
		<p>Tools</p>
		<ul>
		  <li><a href="preferences.html">Preferences</a>
		</ul>
	      </div>
            
285 286 287 288 289 290 291 292 293
          </div>
        </div>
        <div id="centre_column">
          <div id="content_header">
            <div id="title_bar">
              <div id="page_name">
                <h1>perlutil</h1>
              </div>
              <div id="perl_version">
294
                Perl 5 version 26.0 documentation
295
              </div>
296
              <div class="page_links" id="page_links_top">
297 298
                <a href="#" onClick="toolbar.goToTop();return false;">Go to top</a>
		
299 300
              </div>
	      <div class="page_links" id="page_links_bottom">
301
		
302
                  <a href="#" id="page_index_toggle">Show page index</a> &bull;
303
		
304 305 306 307 308 309 310
                <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>
311 312 313 314 315 316 317 318 319 320 321
            </div>
            <div id="breadcrumbs">
                
    <a href="index.html">Home</a> &gt;
    
      
        <a href="index-utilities.html">Utilities</a> &gt;
      
    
    perlutil
  
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
            </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>
363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378

	    <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>
  
379 380 381 382 383
	    <div id="from_search"></div>
            <h1>perlutil</h1>


  <!--    -->
384
<ul><li><a href="#NAME">NAME</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#LIST-OF-UTILITIES">LIST OF UTILITIES</a><ul><li><a href="#Documentation">Documentation</a><li><a href="#Converters">Converters</a><li><a href="#Administration">Administration</a><li><a href="#Development">Development</a><li><a href="#General-tools">General tools</a><li><a href="#Installation">Installation</a></ul><li><a href="#SEE-ALSO">SEE ALSO</a></ul><a name="NAME"></a><h1>NAME</h1>
385 386 387 388 389 390
<p>perlutil - utilities packaged with the Perl distribution</p>
<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>
<p>Along with the Perl interpreter itself, the Perl distribution installs a
range of utilities on your system. There are also several utilities
which are used by the Perl distribution itself as part of the install
process. This document exists to list all of these utilities, explain
391
what they are for and provide pointers to each module's documentation,
392
if appropriate.</p>
393 394
<a name="LIST-OF-UTILITIES"></a><h1>LIST OF UTILITIES</h1>
<a name="Documentation"></a><h2>Documentation</h2>
395 396
<ul>
<li><a name="perldoc"></a><b><a href="perldoc.html">perldoc</a></b>
397
<p>The main interface to Perl's documentation is <code class="inline"><span class="w">perldoc</span></code>
398
, although
399
if you're reading this, it's more than likely that you've already found
400 401 402
it. <i>perldoc</i> will extract and format the documentation from any file
in the current directory, any Perl module installed on the system, or
any of the standard documentation pages, such as this one. Use 
403
<code class="inline"><span class="w">perldoc</span> <span class="q">&lt;name&gt;</span></code>
404 405 406 407
 to get information on any of the utilities
described in this document.</p>
</li>
<li><a name="pod2man-and-pod2text"></a><b><a href="pod2man.html">pod2man</a> and <a href="pod2text.html">pod2text</a></b>
408
<p>If it's run from a terminal, <i>perldoc</i> will usually call <i>pod2man</i> to
409 410
translate POD (Plain Old Documentation - see <a href="perlpod.html">perlpod</a> for an
explanation) into a manpage, and then run <i>man</i> to display it; if
411
<i>man</i> isn't available, <i>pod2text</i> will be used instead and the output
412 413
piped through your favourite pager.</p>
</li>
414 415 416
<li><a name="pod2html"></a><b><a href="pod2html.html">pod2html</a></b>
<p>As well as these two, there is another converter: <i>pod2html</i> will
produce HTML pages from POD.</p>
417 418 419
</li>
<li><a name="pod2usage"></a><b><a href="pod2usage.html">pod2usage</a></b>
<p>If you just want to know how to use the utilities described here,
420
<i>pod2usage</i> will just extract the "USAGE" section; some of
421
the utilities will automatically call <i>pod2usage</i> on themselves when
422
you call them with <code class="inline">-<span class="w">help</span></code>
423 424 425 426 427
.</p>
</li>
<li><a name="podselect"></a><b><a href="podselect.html">podselect</a></b>
<p><i>pod2usage</i> is a special case of <i>podselect</i>, a utility to extract
named sections from documents written in POD. For instance, while
428
utilities have "USAGE" sections, Perl modules usually have "SYNOPSIS"
429
sections: <code class="inline"><span class="w">podselect</span> -s <span class="q">&quot;SYNOPSIS&quot;</span> ...</code>
430 431 432 433
 will extract this section for
a given file.</p>
</li>
<li><a name="podchecker"></a><b><a href="podchecker.html">podchecker</a></b>
434
<p>If you're writing your own documentation in POD, the <i>podchecker</i>
435 436 437 438
utility will look for errors in your markup.</p>
</li>
<li><a name="splain"></a><b><a href="splain.html">splain</a></b>
<p><i>splain</i> is an interface to <a href="perldiag.html">perldiag</a> - paste in your error message
439
to it, and it'll explain it for you.</p>
440
</li>
441 442
<li><a name="roffitall"></a><b><code class="inline"><span class="w">roffitall</span></code>
</b>
443
<p>The <code class="inline"><span class="w">roffitall</span></code>
444 445 446 447 448 449
 utility is not installed on your system but lives in
the <i>pod/</i> directory of your Perl source kit; it converts all the
documentation from the distribution to <i>*roff</i> format, and produces a
typeset PostScript or text file of the whole lot.</p>
</li>
</ul>
450
<a name="Converters"></a><h2>Converters</h2>
451 452 453
<p>To help you convert legacy programs to more modern Perl, the
<a href="pl2pm.html">pl2pm</a> utility will help you convert old-style Perl 4 libraries
to new-style Perl5 modules.</p>
454 455 456 457 458
<a name="Administration"></a><h2>Administration</h2>
<ul>
<li><a name="libnetcfg"></a><b><a href="libnetcfg.html">libnetcfg</a></b>
<p>To display and change the libnet configuration run the libnetcfg command.</p>
</li>
459 460 461 462
<li><a name="the-perlivp-manpage"></a><b><a href="perlivp.html">perlivp</a></b>
<p>The <i>perlivp</i> program is set up at Perl source code build time to test
the Perl version it was built under.  It can be used after running <code class="inline"><span class="w">make</span>
<span class="w">install</span></code>
463
 (or your platform's equivalent procedure) to verify that perl
464 465
and its libraries have been installed correctly.</p>
</li>
466 467 468 469 470 471 472 473 474 475 476
</ul>
<a name="Development"></a><h2>Development</h2>
<p>There are a set of utilities which help you in developing Perl programs, 
and in particular, extending Perl with C.</p>
<ul>
<li><a name="perlbug"></a><b><a href="perlbug.html">perlbug</a></b>
<p><i>perlbug</i> is the recommended way to report bugs in the perl interpreter
itself or any of the standard library modules back to the developers;
please read through the documentation for <i>perlbug</i> thoroughly before
using it to submit a bug report.</p>
</li>
477
<li><a name="perlbug"></a><b><a href="perlbug.html">perlthanks</a></b>
478
<p>This program provides an easy way to send a thank-you message back to the
479
authors and maintainers of perl. It's just <i>perlbug</i> installed under
480 481
another name.</p>
</li>
482 483 484 485 486 487 488 489 490 491 492
<li><a name="h2ph"></a><b><a href="h2ph.html">h2ph</a></b>
<p>Back before Perl had the XS system for connecting with C libraries,
programmers used to get library constants by reading through the C
header files. You may still see <code class="inline"><a class="l_k" href="functions/require.html">require</a> <span class="q">&#39;syscall.ph&#39;</span></code>
 or similar
around - the <i>.ph</i> file should be created by running <i>h2ph</i> on the
corresponding <i>.h</i> file. See the <i>h2ph</i> documentation for more on how
to convert a whole bunch of header files at once.</p>
</li>
<li><a name="h2xs"></a><b><a href="h2xs.html">h2xs</a></b>
<p><i>h2xs</i> converts C header files into XS modules, and will try and write
493
as much glue between C libraries and Perl modules as it can. It's also
494 495
very useful for creating skeletons of pure Perl modules.</p>
</li>
496 497 498 499 500 501 502 503 504 505 506 507 508 509 510
<li><a name="the-enc2xs-manpage"></a><b><a href="enc2xs.html">enc2xs</a></b>
<p><i>enc2xs</i> builds a Perl extension for use by Encode from either
Unicode Character Mapping files (.ucm) or Tcl Encoding Files (.enc).
Besides being used internally during the build process of the Encode
module, you can use <i>enc2xs</i> to add your own encoding to perl.
No knowledge of XS is necessary.</p>
</li>
<li><a name="the-xsubpp-manpage"></a><b><a href="xsubpp.html">xsubpp</a></b>
<p><i>xsubpp</i> is a compiler to convert Perl XS code into C code.
It is typically run by the makefiles created by <a href="ExtUtils/MakeMaker.html">ExtUtils::MakeMaker</a>.</p>
<p><i>xsubpp</i> will compile XS code into C code by embedding the constructs
necessary to let C functions manipulate Perl values and creates the glue
necessary to let Perl access those functions.</p>
</li>
<li><a name="the-prove-manpage"></a><b><a href="prove.html">prove</a></b>
511 512
<p><i>prove</i> is a command-line interface to the test-running functionality
of <i>Test::Harness</i>.  It's an alternative to <code class="inline"><span class="w">make</span> <span class="w">test</span></code>
513 514 515 516 517 518 519 520 521 522 523 524 525 526 527
.</p>
</li>
<li><a name="the-corelist-manpage"></a><b><a href="corelist.html">corelist</a></b>
<p>A command-line front-end to <code class="inline"><span class="w">Module::CoreList</span></code>
, to query what modules
were shipped with given versions of perl.</p>
</li>
</ul>
<a name="General-tools"></a><h2>General tools</h2>
<p>A few general-purpose tools are shipped with perl, mostly because they
came along modules included in the perl distribution.</p>
<ul>
<li><a name="the-piconv-manpage"></a><b><a href="piconv.html">piconv</a></b>
<p><b>piconv</b> is a Perl version of <b>iconv</b>, a character encoding converter
widely available for various Unixen today.  This script was primarily a
528
technology demonstrator for Perl v5.8.0, but you can use piconv in the
529 530 531 532 533 534 535 536 537
place of iconv for virtually any case.</p>
</li>
<li><a name="the-ptar-manpage"></a><b><a href="ptar.html">ptar</a></b>
<p><i>ptar</i> is a tar-like program, written in pure Perl.</p>
</li>
<li><a name="the-ptardiff-manpage"></a><b><a href="ptardiff.html">ptardiff</a></b>
<p><i>ptardiff</i> is a small utility that produces a diff between an extracted
archive and an unextracted one. (Note that this utility requires the
<code class="inline"><span class="w">Text::Diff</span></code>
538
 module to function properly; this module isn't distributed
539 540
with perl, but is available from the CPAN.)</p>
</li>
541 542 543 544
<li><a name="the-ptargrep-manpage"></a><b><a href="ptargrep.html">ptargrep</a></b>
<p><i>ptargrep</i> is a utility to apply pattern matching to the contents of files 
in a tar archive.</p>
</li>
545 546 547 548 549
<li><a name="the-shasum-manpage"></a><b><a href="shasum.html">shasum</a></b>
<p>This utility, that comes with the <code class="inline"><span class="w">Digest::SHA</span></code>
 module, is used to print
or verify SHA checksums.</p>
</li>
550 551 552 553
<li><a name="the-zipdetails-manpage"></a><b><a href="zipdetails.html">zipdetails</a></b>
<p><a href="zipdetails.html">zipdetails</a> displays information about the internal record structure of the zip file.
It is not concerned with displaying any details of the compressed data stored in the zip file.</p>
</li>
554 555
</ul>
<a name="Installation"></a><h2>Installation</h2>
556
<p>These utilities help manage extra Perl modules that don't come with the perl
557 558 559 560 561 562
distribution.</p>
<ul>
<li><a name="the-cpan-manpage"></a><b><a href="cpan.html">cpan</a></b>
<p><i>cpan</i> is a command-line interface to CPAN.pm.  It allows you to install
modules or distributions from CPAN, or just get information about them, and
a lot more.  It is similar to the command line mode of the <a href="CPAN.html">CPAN</a> module,</p>
563
<pre class="verbatim"><ol><li>    <span class="w">perl</span> -<span class="w">MCPAN</span> -e <span class="w">shell</span></li></ol></pre></li>
564 565 566
<li><a name="the-instmodsh-manpage"></a><b><a href="instmodsh.html">instmodsh</a></b>
<p>A little interface to ExtUtils::Installed to examine installed modules,
validate your packlists and even create a tarball from an installed module.</p>
567 568
</li>
</ul>
569
<a name="SEE-ALSO"></a><h1>SEE ALSO</h1>
570 571 572
<p><a href="perldoc.html">perldoc</a>, <a href="pod2man.html">pod2man</a>, <a href="perlpod.html">perlpod</a>,
<a href="pod2html.html">pod2html</a>, <a href="pod2usage.html">pod2usage</a>, <a href="podselect.html">podselect</a>,
<a href="podchecker.html">podchecker</a>, <a href="splain.html">splain</a>, <a href="perldiag.html">perldiag</a>,
573
<code class="inline"><span class="w">roffitall</span>|<span class="w">roffitall</span></code>
574
, <a href="File/Find.html">File::Find</a>, <a href="pl2pm.html">pl2pm</a>,
575
<a href="perlbug.html">perlbug</a>, <a href="h2ph.html">h2ph</a>, <a href="h2xs.html">h2xs</a>, <a href="enc2xs.html">enc2xs</a>,
576 577
<a href="xsubpp.html">xsubpp</a>, <a href="cpan.html">cpan</a>, <a href="instmodsh.html">instmodsh</a>, <a href="piconv.html">piconv</a>, <a href="prove.html">prove</a>, <a href="corelist.html">corelist</a>, <a href="ptar.html">ptar</a>,
<a href="ptardiff.html">ptardiff</a>, <a href="shasum.html">shasum</a>, <a href="zipdetails.html">zipdetails</a></p>
578 579 580 581




582 583 584 585 586
  <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>
587
    </div>
588 589
    <div id="page_index_content" class="hud_content">
      <ul><li><a href="#NAME">NAME</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#LIST-OF-UTILITIES">LIST OF UTILITIES</a><ul><li><a href="#Documentation">Documentation</a><li><a href="#Converters">Converters</a><li><a href="#Administration">Administration</a><li><a href="#Development">Development</a><li><a href="#General-tools">General tools</a><li><a href="#Installation">Installation</a></ul><li><a href="#SEE-ALSO">SEE ALSO</a></ul>
590
    </div>
591 592 593 594
    <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>
595 596 597
    </div>
  </div>

598 599 600 601 602 603 604

	    &nbsp;
          </div>
          <div id="content_footer">
          </div>
        </div>
        <div class="clear"></div>
605
      </div>
606
      
607 608 609 610 611 612 613 614 615
    <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">
616
	      Site maintained by <a href="mailto:jj@jonallen.info">Jon Allen (JJ)</a><br>
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 646 647 648 649 650 651 652
	    </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">
653
      </div>
654
    </div>
655
      
656
    </div>
657 658
      <script language="JavaScript" type="text/javascript" src="static/exploreperl.js"></script>
      <script language="JavaScript" src="static/combined-20100403.js" type="text/javascript"></script>
659 660 661 662 663
<script language="JavaScript" type="text/javascript">
  perldoc.setPath(0);
  perldoc.pageName    = 'perlutil';
  perldoc.pageAddress = 'perlutil.html';
  perldoc.contentPage = 1;
664 665
  explorePerl.render();
  explorePerl.addEvents('explore_anchor');
666 667 668
</script>
    
  </body>
669
</html>