perlfaq - frequently asked questions about Perl ($Date: 1998/07/20 23:12:17 $)

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>perlfaq - frequently asked questions about Perl ($Date: 1998/07/20 23:12:17 $) - Perldoc Browser</title> <link rel="search" href="/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser"> <link rel="canonical" href="https://perldoc.perl.org/perlfaq"> <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous"> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" /> <style> body { background: #f4f4f5; color: #020202; } .navbar-dark { background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%); background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%); background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%); filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0); background-repeat: repeat-x; } .navbar-dark .navbar-nav .nav-link, .navbar-dark .navbar-nav .nav-link:focus { color: #fff } .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 } #wrapperlicious { margin: 0 auto; font: 0.9em 'Helvetica Neue', Helvetica, sans-serif; font-weight: normal; line-height: 1.5em; margin: 0; padding: 0; } #wrapperlicious h1 { font-size: 1.5em } #wrapperlicious h2 { font-size: 1.3em } #wrapperlicious h3 { font-size: 1.1em } #wrapperlicious h4 { font-size: 0.9em } #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3, #wrapperlicious h4, #wrapperlicious dt { color: #020202; margin-top: 1em; margin-bottom: 1em; position: relative; font-weight: bold; } #wrapperlicious a { color: inherit; text-decoration: underline } #wrapperlicious #toc { text-decoration: none } #wrapperlicious a:hover { color: #2a2a2a } #wrapperlicious a img { border: 0 } #wrapperlicious :not(pre) > code { color: inherit; background-color: rgba(0, 0, 0, 0.04); border-radius: 3px; font: 0.9em Consolas, Menlo, Monaco, monospace; padding: 0.3em; } #wrapperlicious dd { margin: 0; margin-left: 2em; } #wrapperlicious dt { color: #2a2a2a; font-weight: bold; margin-left: 0.9em; } #wrapperlicious p { margin-bottom: 1em; margin-top: 1em; } #wrapperlicious li > p { margin-bottom: 0; margin-top: 0; } #wrapperlicious pre { border: 1px solid #c1c1c1; border-radius: 3px; font: 100% Consolas, Menlo, Monaco, monospace; margin-bottom: 1em; margin-top: 1em; } #wrapperlicious pre > code { display: block; background-color: #f6f6f6; font: 0.9em Consolas, Menlo, Monaco, monospace; line-height: 1.5em; text-align: left; white-space: pre; padding: 1em; } #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul { margin-bottom: 1em; margin-top: 1em; } #wrapperlicious ul { list-style-type: square; } #wrapperlicious ul ul { margin-bottom: 0px; margin-top: 0px; } #footer { font-size: 0.8em; padding-top: 0.5em; text-align: center; } #more { display: inline; font-size: 0.8em; } #perldocdiv { background-color: #fff; border: 1px solid #c1c1c1; border-bottom-left-radius: 5px; border-bottom-right-radius: 5px; margin-left: auto; margin-right: auto; padding: 3em; padding-top: 1em; max-width: 960px; } #moduleversion { float: right } #wrapperlicious .leading-notice { font-style: italic; padding-left: 1em; margin-top: 1em; margin-bottom: 1em; } #wrapperlicious .permalink { display: none; left: -0.75em; position: absolute; padding-right: 0.25em; text-decoration: none; } #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink, #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink, #wrapperlicious dt:hover .permalink { display: block; } </style>  <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-KVNWBNT5FB'); gtag('config', 'UA-50555-3'); </script> </head> <body> <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between"> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <a class="navbar-brand" href="/"><img src="/images/perl_camel_30.png" width="30" height="30" class="d-inline-block align-top" alt="Perl Camel Logo"> Perldoc Browser</a> <div class="collapse navbar-collapse" id="navbarNav"> <ul class="navbar-nav mr-auto"> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.005</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-stable"> <a class="dropdown-item" href="/perlfaq">Latest</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1/perlfaq">5.40.1</a> <a class="dropdown-item" href="/5.40.0/perlfaq">5.40.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3/perlfaq">5.38.3</a> <a class="dropdown-item" href="/5.38.2/perlfaq">5.38.2</a> <a class="dropdown-item" href="/5.38.1/perlfaq">5.38.1</a> <a class="dropdown-item" href="/5.38.0/perlfaq">5.38.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.36.3/perlfaq">5.36.3</a> <a class="dropdown-item" href="/5.36.2/perlfaq">5.36.2</a> <a class="dropdown-item" href="/5.36.1/perlfaq">5.36.1</a> <a class="dropdown-item" href="/5.36.0/perlfaq">5.36.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.34.3/perlfaq">5.34.3</a> <a class="dropdown-item" href="/5.34.2/perlfaq">5.34.2</a> <a class="dropdown-item" href="/5.34.1/perlfaq">5.34.1</a> <a class="dropdown-item" href="/5.34.0/perlfaq">5.34.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.32.1/perlfaq">5.32.1</a> <a class="dropdown-item" href="/5.32.0/perlfaq">5.32.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.30.3/perlfaq">5.30.3</a> <a class="dropdown-item" href="/5.30.2/perlfaq">5.30.2</a> <a class="dropdown-item" href="/5.30.1/perlfaq">5.30.1</a> <a class="dropdown-item" href="/5.30.0/perlfaq">5.30.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.28.3/perlfaq">5.28.3</a> <a class="dropdown-item" href="/5.28.2/perlfaq">5.28.2</a> <a class="dropdown-item" href="/5.28.1/perlfaq">5.28.1</a> <a class="dropdown-item" href="/5.28.0/perlfaq">5.28.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.26.3/perlfaq">5.26.3</a> <a class="dropdown-item" href="/5.26.2/perlfaq">5.26.2</a> <a class="dropdown-item" href="/5.26.1/perlfaq">5.26.1</a> <a class="dropdown-item" href="/5.26.0/perlfaq">5.26.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.24.4/perlfaq">5.24.4</a> <a class="dropdown-item" href="/5.24.3/perlfaq">5.24.3</a> <a class="dropdown-item" href="/5.24.2/perlfaq">5.24.2</a> <a class="dropdown-item" href="/5.24.1/perlfaq">5.24.1</a> <a class="dropdown-item" href="/5.24.0/perlfaq">5.24.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.22.4/perlfaq">5.22.4</a> <a class="dropdown-item" href="/5.22.3/perlfaq">5.22.3</a> <a class="dropdown-item" href="/5.22.2/perlfaq">5.22.2</a> <a class="dropdown-item" href="/5.22.1/perlfaq">5.22.1</a> <a class="dropdown-item" href="/5.22.0/perlfaq">5.22.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.20.3/perlfaq">5.20.3</a> <a class="dropdown-item" href="/5.20.2/perlfaq">5.20.2</a> <a class="dropdown-item" href="/5.20.1/perlfaq">5.20.1</a> <a class="dropdown-item" href="/5.20.0/perlfaq">5.20.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.18.4/perlfaq">5.18.4</a> <a class="dropdown-item" href="/5.18.3/perlfaq">5.18.3</a> <a class="dropdown-item" href="/5.18.2/perlfaq">5.18.2</a> <a class="dropdown-item" href="/5.18.1/perlfaq">5.18.1</a> <a class="dropdown-item" href="/5.18.0/perlfaq">5.18.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.16.3/perlfaq">5.16.3</a> <a class="dropdown-item" href="/5.16.2/perlfaq">5.16.2</a> <a class="dropdown-item" href="/5.16.1/perlfaq">5.16.1</a> <a class="dropdown-item" href="/5.16.0/perlfaq">5.16.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.14.4/perlfaq">5.14.4</a> <a class="dropdown-item" href="/5.14.3/perlfaq">5.14.3</a> <a class="dropdown-item" href="/5.14.2/perlfaq">5.14.2</a> <a class="dropdown-item" href="/5.14.1/perlfaq">5.14.1</a> <a class="dropdown-item" href="/5.14.0/perlfaq">5.14.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.12.5/perlfaq">5.12.5</a> <a class="dropdown-item" href="/5.12.4/perlfaq">5.12.4</a> <a class="dropdown-item" href="/5.12.3/perlfaq">5.12.3</a> <a class="dropdown-item" href="/5.12.2/perlfaq">5.12.2</a> <a class="dropdown-item" href="/5.12.1/perlfaq">5.12.1</a> <a class="dropdown-item" href="/5.12.0/perlfaq">5.12.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.10.1/perlfaq">5.10.1</a> <a class="dropdown-item" href="/5.10.0/perlfaq">5.10.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.8.9/perlfaq">5.8.9</a> <a class="dropdown-item" href="/5.8.8/perlfaq">5.8.8</a> <a class="dropdown-item" href="/5.8.7/perlfaq">5.8.7</a> <a class="dropdown-item" href="/5.8.6/perlfaq">5.8.6</a> <a class="dropdown-item" href="/5.8.5/perlfaq">5.8.5</a> <a class="dropdown-item" href="/5.8.4/perlfaq">5.8.4</a> <a class="dropdown-item" href="/5.8.3/perlfaq">5.8.3</a> <a class="dropdown-item" href="/5.8.2/perlfaq">5.8.2</a> <a class="dropdown-item" href="/5.8.1/perlfaq">5.8.1</a> <a class="dropdown-item" href="/5.8.0/perlfaq">5.8.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.6.2/perlfaq">5.6.2</a> <a class="dropdown-item" href="/5.6.1/perlfaq">5.6.1</a> <a class="dropdown-item" href="/5.6.0/perlfaq">5.6.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.005_04/perlfaq">5.005_04</a> <a class="dropdown-item" href="/5.005_03/perlfaq">5.005_03</a> <a class="dropdown-item" href="/5.005_02/perlfaq">5.005_02</a> <a class="dropdown-item" href="/5.005_01/perlfaq">5.005_01</a> <a class="dropdown-item active" href="/5.005/perlfaq">5.005</a> </div> </li> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-dev"> <a class="dropdown-item" href="/blead/perlfaq">blead</a> <a class="dropdown-item" href="/5.41.9/perlfaq">5.41.9</a> <a class="dropdown-item" href="/5.41.8/perlfaq">5.41.8</a> <a class="dropdown-item" href="/5.41.7/perlfaq">5.41.7</a> <a class="dropdown-item" href="/5.41.6/perlfaq">5.41.6</a> <a class="dropdown-item" href="/5.41.5/perlfaq">5.41.5</a> <a class="dropdown-item" href="/5.41.4/perlfaq">5.41.4</a> <a class="dropdown-item" href="/5.41.3/perlfaq">5.41.3</a> <a class="dropdown-item" href="/5.41.2/perlfaq">5.41.2</a> <a class="dropdown-item" href="/5.41.1/perlfaq">5.41.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1-RC1/perlfaq">5.40.1-RC1</a> <a class="dropdown-item" href="/5.40.0-RC2/perlfaq">5.40.0-RC2</a> <a class="dropdown-item" href="/5.40.0-RC1/perlfaq">5.40.0-RC1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.39.10/perlfaq">5.39.10</a> <a class="dropdown-item" href="/5.39.9/perlfaq">5.39.9</a> <a class="dropdown-item" href="/5.39.8/perlfaq">5.39.8</a> <a class="dropdown-item" href="/5.39.7/perlfaq">5.39.7</a> <a class="dropdown-item" href="/5.39.6/perlfaq">5.39.6</a> <a class="dropdown-item" href="/5.39.5/perlfaq">5.39.5</a> <a class="dropdown-item" href="/5.39.4/perlfaq">5.39.4</a> <a class="dropdown-item" href="/5.39.3/perlfaq">5.39.3</a> <a class="dropdown-item" href="/5.39.2/perlfaq">5.39.2</a> <a class="dropdown-item" href="/5.39.1/perlfaq">5.39.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3-RC1/perlfaq">5.38.3-RC1</a> </div> </li> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-nav"> <a class="dropdown-item" href="/5.005/perl">Perl</a> <a class="dropdown-item" href="/5.005/perlintro">Intro</a> <a class="dropdown-item" href="/5.005/perl#Tutorials">Tutorials</a> <a class="dropdown-item" href="/5.005/perlfaq">FAQs</a> <a class="dropdown-item" href="/5.005/perl#Reference-Manual">Reference</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.005/perlop">Operators</a> <a class="dropdown-item" href="/5.005/functions">Functions</a> <a class="dropdown-item" href="/5.005/variables">Variables</a> <a class="dropdown-item" href="/5.005/modules">Modules</a> <a class="dropdown-item" href="/5.005/perlutil">Utilities</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.005/perldelta">Release Notes</a> <a class="dropdown-item" href="/5.005/perlcommunity">Community</a> <a class="dropdown-item" href="/5.005/perlhist">History</a> </div> </li> </ul> <ul class="navbar-nav"> <script> function set_expand (expand) { var perldocdiv = document.getElementById('perldocdiv'); var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width'); var expanded = (width == '' || width == 'none') ? true : false; if (expand === null) { expand = !expanded; } if ((expand && !expanded) || (!expand && expanded)) { perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px'); var button_classlist = document.getElementById('content-expand-button').classList; if (expand) { button_classlist.add('btn-light'); button_classlist.remove('btn-outline-light'); } else { button_classlist.add('btn-outline-light'); button_classlist.remove('btn-light'); } } return expand; } function toggle_expand () { var expand = set_expand(null); document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC'; } function read_expand () { return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', function () { if (read_expand()) { set_expand(true); } }); } else if (read_expand()) { set_expand(true); } </script> <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-4" onclick="toggle_expand()">Expand</button> </ul> <form class="form-inline" method="get" action="/5.005/search"> <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search" value=""> </form> </div> </nav> <div id="wrapperlicious" class="container-fluid"> <div id="perldocdiv"> <div id="links"> <a href="/5.005/perlfaq">perlfaq</a> <div id="more"> (<a href="/5.005/perlfaq.txt">source</a>, <a href="https://metacpan.org/pod/perlfaq">CPAN</a>) </div> </div> <div class="leading-notice"> You are viewing the version of this documentation from Perl 5.005. <a href="/perlfaq">View the latest version</a> </div> <h1><a id="toc">CONTENTS</a></h1> <ul> <li> <a class="text-decoration-none" href="#NAME">NAME</a> </li> <li> <a class="text-decoration-none" href="#DESCRIPTION">DESCRIPTION</a> <ul> <li> <a class="text-decoration-none" href="#Where-to-get-this-document">Where to get this document</a> </li> <li> <a class="text-decoration-none" href="#How-to-contribute-to-this-document">How to contribute to this document</a> </li> <li> <a class="text-decoration-none" href="#What-will-happen-if-you-mail-your-Perl-programming-problems-to-the-authors">What will happen if you mail your Perl programming problems to the authors</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Credits">Credits</a> </li> <li> <a class="text-decoration-none" href="#Author-and-Copyright-Information">Author and Copyright Information</a> <ul> <li> <a class="text-decoration-none" href="#Bundled-Distributions">Bundled Distributions</a> </li> <li> <a class="text-decoration-none" href="#Disclaimer">Disclaimer</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Changes">Changes</a> </li> </ul> <h1 id="NAME"><a class="permalink" href="#NAME">#</a>NAME</h1> <p>perlfaq - frequently asked questions about Perl ($Date: 1998/07/20 23:12:17 $)</p> <h1 id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">#</a>DESCRIPTION</h1> <p>This document is structured into the following sections:</p> <dl> <dt id="perlfaq:-Structural-overview-of-the-FAQ."><a class="permalink" href="#perlfaq:-Structural-overview-of-the-FAQ.">#</a><a id="perlfaq"></a><a id="perlfaq:-Structural-overview-of-the-FAQ"></a>perlfaq: Structural overview of the FAQ.</dt> <dd> <p>This document.</p> </dd> <dt id="perlfaq1:-General-Questions-About-Perl"><a class="permalink" href="#perlfaq1:-General-Questions-About-Perl">#</a><a id="perlfaq1"></a><a href="/5.005/perlfaq1">perlfaq1</a>: General Questions About Perl</dt> <dd> <p>Very general, high-level information about Perl.</p> </dd> <dt id="perlfaq2:-Obtaining-and-Learning-about-Perl"><a class="permalink" href="#perlfaq2:-Obtaining-and-Learning-about-Perl">#</a><a id="perlfaq2"></a><a href="/5.005/perlfaq2">perlfaq2</a>: Obtaining and Learning about Perl</dt> <dd> <p>Where to find source and documentation to Perl, support, and related matters.</p> </dd> <dt id="perlfaq3:-Programming-Tools"><a class="permalink" href="#perlfaq3:-Programming-Tools">#</a><a id="perlfaq3"></a><a href="/5.005/perlfaq3">perlfaq3</a>: Programming Tools</dt> <dd> <p>Programmer tools and programming support.</p> </dd> <dt id="perlfaq4:-Data-Manipulation"><a class="permalink" href="#perlfaq4:-Data-Manipulation">#</a><a id="perlfaq4"></a><a href="/5.005/perlfaq4">perlfaq4</a>: Data Manipulation</dt> <dd> <p>Manipulating numbers, dates, strings, arrays, hashes, and miscellaneous data issues.</p> </dd> <dt id="perlfaq5:-Files-and-Formats"><a class="permalink" href="#perlfaq5:-Files-and-Formats">#</a><a id="perlfaq5"></a><a href="/5.005/perlfaq5">perlfaq5</a>: Files and Formats</dt> <dd> <p>I/O and the "f" issues: filehandles, flushing, formats and footers.</p> </dd> <dt id="perlfaq6:-Regexps"><a class="permalink" href="#perlfaq6:-Regexps">#</a><a id="perlfaq6"></a><a href="/5.005/perlfaq6">perlfaq6</a>: Regexps</dt> <dd> <p>Pattern matching and regular expressions.</p> </dd> <dt id="perlfaq7:-General-Perl-Language-Issues"><a class="permalink" href="#perlfaq7:-General-Perl-Language-Issues">#</a><a id="perlfaq7"></a><a href="/5.005/perlfaq7">perlfaq7</a>: General Perl Language Issues</dt> <dd> <p>General Perl language issues that don't clearly fit into any of the other sections.</p> </dd> <dt id="perlfaq8:-System-Interaction"><a class="permalink" href="#perlfaq8:-System-Interaction">#</a><a id="perlfaq8"></a><a href="/5.005/perlfaq8">perlfaq8</a>: System Interaction</dt> <dd> <p>Interprocess communication (IPC), control over the user-interface (keyboard, screen and pointing devices).</p> </dd> <dt id="perlfaq9:-Networking"><a class="permalink" href="#perlfaq9:-Networking">#</a><a id="perlfaq9"></a><a href="/5.005/perlfaq9">perlfaq9</a>: Networking</dt> <dd> <p>Networking, the Internet, and a few on the web.</p> </dd> </dl> <h2 id="Where-to-get-this-document"><a class="permalink" href="#Where-to-get-this-document">#</a><a id="Where"></a>Where to get this document</h2> <p>This document is posted regularly to comp.lang.perl.announce and several other related newsgroups. It is available in a variety of formats from CPAN in the /CPAN/doc/FAQs/FAQ/ directory, or on the web at http://www.perl.com/perl/faq/ .</p> <h2 id="How-to-contribute-to-this-document"><a class="permalink" href="#How-to-contribute-to-this-document">#</a><a id="How"></a>How to contribute to this document</h2> <p>You may mail corrections, additions, and suggestions to perlfaq-suggestions@perl.com . This alias should not be used to <i>ask</i> FAQs. It's for fixing the current FAQ.</p> <h2 id="What-will-happen-if-you-mail-your-Perl-programming-problems-to-the-authors"><a class="permalink" href="#What-will-happen-if-you-mail-your-Perl-programming-problems-to-the-authors">#</a><a id="What"></a>What will happen if you mail your Perl programming problems to the authors</h2> <p>Your questions will probably go unread, unless they're suggestions of new questions to add to the FAQ, in which case they should have gone to the perlfaq-suggestions@perl.com instead.</p> <p>You should have read section 2 of this faq. There you would have learned that comp.lang.perl.misc is the appropriate place to go for free advice. If your question is really important and you require a prompt and correct answer, you should hire a consultant.</p> <h1 id="Credits"><a class="permalink" href="#Credits">#</a>Credits</h1> <p>When I first began the Perl FAQ in the late 80s, I never realized it would have grown to over a hundred pages, nor that Perl would ever become so popular and widespread. This document could not have been written without the tremendous help provided by Larry Wall and the rest of the Perl Porters.</p> <h1 id="Author-and-Copyright-Information"><a class="permalink" href="#Author-and-Copyright-Information">#</a><a id="Author"></a>Author and Copyright Information</h1> <p>Copyright (c) 1997, 1998 Tom Christiansen and Nathan Torkington. All rights reserved.</p> <h2 id="Bundled-Distributions"><a class="permalink" href="#Bundled-Distributions">#</a><a id="Bundled"></a>Bundled Distributions</h2> <p>When included as part of the Standard Version of Perl, or as part of its complete documentation whether printed or otherwise, this work may be distributed only under the terms of Perl's Artistic License. Any distribution of this file or derivatives thereof <i>outside</i> of that package require that special arrangements be made with copyright holder.</p> <p>Irrespective of its distribution, all code examples in these files are hereby placed into the public domain. You are permitted and encouraged to use this code in your own programs for fun or for profit as you see fit. A simple comment in the code giving credit would be courteous but is not required.</p> <h2 id="Disclaimer"><a class="permalink" href="#Disclaimer">#</a>Disclaimer</h2> <p>This information is offered in good faith and in the hope that it may be of use, but is not guaranteed to be correct, up to date, or suitable for any particular purpose whatsoever. The authors accept no liability in respect of this information or its use.</p> <h1 id="Changes"><a class="permalink" href="#Changes">#</a>Changes</h1> <ul> <p>Significant changes throughout in preparation for the 5.005 release.</p> <p>24/April/97</p> <p>Style and whitespace changes from Chip, new question on reading one character at a time from a terminal using POSIX from Tom.</p> <p>23/April/97</p> <p>Added http://www.oasis.leo.org/perl/ to <a href="/5.005/perlfaq2">perlfaq2</a>. Style fix to <a href="/5.005/perlfaq3">perlfaq3</a>. Added floating point precision, fixed complex number arithmetic, cross-references, caveat for Text::Wrap, alternative answer for initial capitalizing, fixed incorrect regexp, added example of Tie::IxHash to <a href="/5.005/perlfaq4">perlfaq4</a>. Added example of passing and storing filehandles, added commify to <a href="/5.005/perlfaq5">perlfaq5</a>. Restored variable suicide, and added mass commenting to <a href="/5.005/perlfaq7">perlfaq7</a>. Added Net::Telnet, fixed backticks, added reader/writer pair to telnet question, added FindBin, grouped module questions together in <a href="/5.005/perlfaq8">perlfaq8</a>. Expanded caveats for the simple URL extractor, gave LWP example, added CGI security question, expanded on the mail address answer in <a href="/5.005/perlfaq9">perlfaq9</a>.</p> <p>25/March/97</p> <p>Added more info to the binary distribution section of <a href="/5.005/perlfaq2">perlfaq2</a>. Added Net::Telnet to <a href="/5.005/perlfaq6">perlfaq6</a>. Fixed typos in <a href="/5.005/perlfaq8">perlfaq8</a>. Added mail sending example to <a href="/5.005/perlfaq9">perlfaq9</a>. Added Merlyn's columns to <a href="/5.005/perlfaq2">perlfaq2</a>.</p> <p>18/March/97</p> <p>Added the DATE to the NAME section, indicating which sections have changed.</p> <p>Mentioned SIGPIPE and <a href="/5.005/perlipc">perlipc</a> in the forking open answer in <a href="/5.005/perlfaq8">perlfaq8</a>.</p> <p>Fixed description of a regular expression in <a href="/5.005/perlfaq4">perlfaq4</a>.</p> <p>17/March/97 Version</p> <p>Various typos fixed throughout.</p> <p>Added new question on Perl BNF on <a href="/5.005/perlfaq7">perlfaq7</a>.</p> <p>Initial Release: 11/March/97</p> <p>This is the initial release of version 3 of the FAQ; consequently there have been no changes since its initial release.</p> </ul> <div class="pod-errors"><p>2 POD Errors</p><div class="pod-errors-detail"><p>The following errors were encountered while parsing the POD:</p><dl><dt><a class="permalink" href="">#</a>Around line 118:</dt><dd><p>You can't have =items (as at line 125) unless the first thing after the =over is an =item</p></dd><dt><a class="permalink" href="">#</a>Around line 120:</dt><dd><p>Unknown directive: =head</p></dd></dl></div></div> </div> <div id="footer"> <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p> <p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p> </div> </div> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script> <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script> <script src="/js/highlight.pack.js"></script> <script>hljs.highlightAll();</script> </body> </html>

CINXE.COM

perlfaq - frequently asked questions about Perl ($Date: 1998/07/20 23:12:17 $) - Perldoc Browser