CINXE.COM
perltodo - Perl TO-DO List - Perldoc Browser
<!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>perltodo - Perl TO-DO List - Perldoc Browser</title> <link rel="search" href="/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser"> <link rel="canonical" href="https://perldoc.perl.org/perltodo"> <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> <!-- Global site tag (gtag.js) - Google Analytics --> <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.8.7</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-stable"> <a class="dropdown-item" href="/perltodo">Latest</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1/perltodo">5.40.1</a> <a class="dropdown-item" href="/5.40.0/perltodo">5.40.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3/perltodo">5.38.3</a> <a class="dropdown-item" href="/5.38.2/perltodo">5.38.2</a> <a class="dropdown-item" href="/5.38.1/perltodo">5.38.1</a> <a class="dropdown-item" href="/5.38.0/perltodo">5.38.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.36.3/perltodo">5.36.3</a> <a class="dropdown-item" href="/5.36.2/perltodo">5.36.2</a> <a class="dropdown-item" href="/5.36.1/perltodo">5.36.1</a> <a class="dropdown-item" href="/5.36.0/perltodo">5.36.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.34.3/perltodo">5.34.3</a> <a class="dropdown-item" href="/5.34.2/perltodo">5.34.2</a> <a class="dropdown-item" href="/5.34.1/perltodo">5.34.1</a> <a class="dropdown-item" href="/5.34.0/perltodo">5.34.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.32.1/perltodo">5.32.1</a> <a class="dropdown-item" href="/5.32.0/perltodo">5.32.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.30.3/perltodo">5.30.3</a> <a class="dropdown-item" href="/5.30.2/perltodo">5.30.2</a> <a class="dropdown-item" href="/5.30.1/perltodo">5.30.1</a> <a class="dropdown-item" href="/5.30.0/perltodo">5.30.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.28.3/perltodo">5.28.3</a> <a class="dropdown-item" href="/5.28.2/perltodo">5.28.2</a> <a class="dropdown-item" href="/5.28.1/perltodo">5.28.1</a> <a class="dropdown-item" href="/5.28.0/perltodo">5.28.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.26.3/perltodo">5.26.3</a> <a class="dropdown-item" href="/5.26.2/perltodo">5.26.2</a> <a class="dropdown-item" href="/5.26.1/perltodo">5.26.1</a> <a class="dropdown-item" href="/5.26.0/perltodo">5.26.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.24.4/perltodo">5.24.4</a> <a class="dropdown-item" href="/5.24.3/perltodo">5.24.3</a> <a class="dropdown-item" href="/5.24.2/perltodo">5.24.2</a> <a class="dropdown-item" href="/5.24.1/perltodo">5.24.1</a> <a class="dropdown-item" href="/5.24.0/perltodo">5.24.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.22.4/perltodo">5.22.4</a> <a class="dropdown-item" href="/5.22.3/perltodo">5.22.3</a> <a class="dropdown-item" href="/5.22.2/perltodo">5.22.2</a> <a class="dropdown-item" href="/5.22.1/perltodo">5.22.1</a> <a class="dropdown-item" href="/5.22.0/perltodo">5.22.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.20.3/perltodo">5.20.3</a> <a class="dropdown-item" href="/5.20.2/perltodo">5.20.2</a> <a class="dropdown-item" href="/5.20.1/perltodo">5.20.1</a> <a class="dropdown-item" href="/5.20.0/perltodo">5.20.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.18.4/perltodo">5.18.4</a> <a class="dropdown-item" href="/5.18.3/perltodo">5.18.3</a> <a class="dropdown-item" href="/5.18.2/perltodo">5.18.2</a> <a class="dropdown-item" href="/5.18.1/perltodo">5.18.1</a> <a class="dropdown-item" href="/5.18.0/perltodo">5.18.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.16.3/perltodo">5.16.3</a> <a class="dropdown-item" href="/5.16.2/perltodo">5.16.2</a> <a class="dropdown-item" href="/5.16.1/perltodo">5.16.1</a> <a class="dropdown-item" href="/5.16.0/perltodo">5.16.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.14.4/perltodo">5.14.4</a> <a class="dropdown-item" href="/5.14.3/perltodo">5.14.3</a> <a class="dropdown-item" href="/5.14.2/perltodo">5.14.2</a> <a class="dropdown-item" href="/5.14.1/perltodo">5.14.1</a> <a class="dropdown-item" href="/5.14.0/perltodo">5.14.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.12.5/perltodo">5.12.5</a> <a class="dropdown-item" href="/5.12.4/perltodo">5.12.4</a> <a class="dropdown-item" href="/5.12.3/perltodo">5.12.3</a> <a class="dropdown-item" href="/5.12.2/perltodo">5.12.2</a> <a class="dropdown-item" href="/5.12.1/perltodo">5.12.1</a> <a class="dropdown-item" href="/5.12.0/perltodo">5.12.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.10.1/perltodo">5.10.1</a> <a class="dropdown-item" href="/5.10.0/perltodo">5.10.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.8.9/perltodo">5.8.9</a> <a class="dropdown-item" href="/5.8.8/perltodo">5.8.8</a> <a class="dropdown-item active" href="/5.8.7/perltodo">5.8.7</a> <a class="dropdown-item" href="/5.8.6/perltodo">5.8.6</a> <a class="dropdown-item" href="/5.8.5/perltodo">5.8.5</a> <a class="dropdown-item" href="/5.8.4/perltodo">5.8.4</a> <a class="dropdown-item" href="/5.8.3/perltodo">5.8.3</a> <a class="dropdown-item" href="/5.8.2/perltodo">5.8.2</a> <a class="dropdown-item" href="/5.8.1/perltodo">5.8.1</a> <a class="dropdown-item" href="/5.8.0/perltodo">5.8.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.6.2/perltodo">5.6.2</a> <a class="dropdown-item" href="/5.6.1/perltodo">5.6.1</a> <a class="dropdown-item" href="/5.6.0/perltodo">5.6.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.005_04/perltodo">5.005_04</a> <a class="dropdown-item" href="/5.005_03/perltodo">5.005_03</a> <a class="dropdown-item" href="/5.005_02/perltodo">5.005_02</a> <a class="dropdown-item" href="/5.005_01/perltodo">5.005_01</a> <a class="dropdown-item" href="/5.005/perltodo">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/perltodo">blead</a> <a class="dropdown-item" href="/5.41.10/perltodo">5.41.10</a> <a class="dropdown-item" href="/5.41.9/perltodo">5.41.9</a> <a class="dropdown-item" href="/5.41.8/perltodo">5.41.8</a> <a class="dropdown-item" href="/5.41.7/perltodo">5.41.7</a> <a class="dropdown-item" href="/5.41.6/perltodo">5.41.6</a> <a class="dropdown-item" href="/5.41.5/perltodo">5.41.5</a> <a class="dropdown-item" href="/5.41.4/perltodo">5.41.4</a> <a class="dropdown-item" href="/5.41.3/perltodo">5.41.3</a> <a class="dropdown-item" href="/5.41.2/perltodo">5.41.2</a> <a class="dropdown-item" href="/5.41.1/perltodo">5.41.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1-RC1/perltodo">5.40.1-RC1</a> <a class="dropdown-item" href="/5.40.0-RC2/perltodo">5.40.0-RC2</a> <a class="dropdown-item" href="/5.40.0-RC1/perltodo">5.40.0-RC1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.39.10/perltodo">5.39.10</a> <a class="dropdown-item" href="/5.39.9/perltodo">5.39.9</a> <a class="dropdown-item" href="/5.39.8/perltodo">5.39.8</a> <a class="dropdown-item" href="/5.39.7/perltodo">5.39.7</a> <a class="dropdown-item" href="/5.39.6/perltodo">5.39.6</a> <a class="dropdown-item" href="/5.39.5/perltodo">5.39.5</a> <a class="dropdown-item" href="/5.39.4/perltodo">5.39.4</a> <a class="dropdown-item" href="/5.39.3/perltodo">5.39.3</a> <a class="dropdown-item" href="/5.39.2/perltodo">5.39.2</a> <a class="dropdown-item" href="/5.39.1/perltodo">5.39.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3-RC1/perltodo">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.8.7/perl">Perl</a> <a class="dropdown-item" href="/5.8.7/perlintro">Intro</a> <a class="dropdown-item" href="/5.8.7/perl#Tutorials">Tutorials</a> <a class="dropdown-item" href="/5.8.7/perlfaq">FAQs</a> <a class="dropdown-item" href="/5.8.7/perl#Reference-Manual">Reference</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.8.7/perlop">Operators</a> <a class="dropdown-item" href="/5.8.7/functions">Functions</a> <a class="dropdown-item" href="/5.8.7/variables">Variables</a> <a class="dropdown-item" href="/5.8.7/modules">Modules</a> <a class="dropdown-item" href="/5.8.7/perlutil">Utilities</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.8.7/perldelta">Release Notes</a> <a class="dropdown-item" href="/5.8.7/perlcommunity">Community</a> <a class="dropdown-item" href="/5.8.7/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.8.7/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.8.7/perltodo">perltodo</a> <div id="more"> (<a href="/5.8.7/perltodo.txt">source</a>, <a href="https://metacpan.org/pod/perltodo">CPAN</a>) </div> </div> <div class="leading-notice"> You are viewing the version of this documentation from Perl 5.8.7. <a href="/perltodo">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> </li> <li> <a class="text-decoration-none" href="#assertions">assertions</a> </li> <li> <a class="text-decoration-none" href="#iCOW">iCOW</a> </li> <li> <a class="text-decoration-none" href="#(?%7B...%7D)-closures-in-regexps">(?{...}) closures in regexps</a> </li> <li> <a class="text-decoration-none" href="#A-re-entrant-regexp-engine">A re-entrant regexp engine</a> </li> <li> <a class="text-decoration-none" href="#pragmata">pragmata</a> <ul> <li> <a class="text-decoration-none" href="#lexical-pragmas">lexical pragmas</a> </li> <li> <a class="text-decoration-none" href="#use-less-'memory'">use less 'memory'</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#prototypes-and-functions">prototypes and functions</a> <ul> <li> <a class="text-decoration-none" href="#_-prototype-character">_ prototype character</a> </li> <li> <a class="text-decoration-none" href="#inlining-autoloaded-constants">inlining autoloaded constants</a> </li> <li> <a class="text-decoration-none" href="#Finish-off-lvalue-functions">Finish off lvalue functions</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Unicode-and-UTF8">Unicode and UTF8</a> <ul> <li> <a class="text-decoration-none" href="#Implicit-Latin-1-=%3E-Unicode-translation">Implicit Latin 1 => Unicode translation</a> </li> <li> <a class="text-decoration-none" href="#UTF8-caching-code">UTF8 caching code</a> </li> <li> <a class="text-decoration-none" href="#Unicode-in-Filenames">Unicode in Filenames</a> </li> <li> <a class="text-decoration-none" href="#Unicode-in-%25ENV">Unicode in %ENV</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Regexps">Regexps</a> <ul> <li> <a class="text-decoration-none" href="#regexp-optimiser-optional">regexp optimiser optional</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#POD">POD</a> <ul> <li> <a class="text-decoration-none" href="#POD-%3E-HTML-conversion-still-sucks">POD -> HTML conversion still sucks</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Misc-medium-sized-projects">Misc medium sized projects</a> <ul> <li> <a class="text-decoration-none" href="#UNITCHECK">UNITCHECK</a> </li> <li> <a class="text-decoration-none" href="#optional-optimizer">optional optimizer</a> </li> <li> <a class="text-decoration-none" href="#You-WANT-*how*-many">You WANT *how* many</a> </li> <li> <a class="text-decoration-none" href="#lexical-aliases">lexical aliases</a> </li> <li> <a class="text-decoration-none" href="#no-6">no 6</a> </li> <li> <a class="text-decoration-none" href="#IPv6">IPv6</a> </li> <li> <a class="text-decoration-none" href="#entersub-XS-vs-Perl">entersub XS vs Perl</a> </li> <li> <a class="text-decoration-none" href="#@INC-source-filter-to-Filter::Simple">@INC source filter to Filter::Simple</a> </li> <li> <a class="text-decoration-none" href="#bincompat-functions">bincompat functions</a> </li> <li> <a class="text-decoration-none" href="#Use-fchown/fchmod-internally">Use fchown/fchmod internally</a> </li> <li> <a class="text-decoration-none" href="#Constant-folding">Constant folding</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Tests">Tests</a> <ul> <li> <a class="text-decoration-none" href="#Make-Schwern-poorer">Make Schwern poorer</a> </li> <li> <a class="text-decoration-none" href="#test-B">test B</a> </li> <li> <a class="text-decoration-none" href="#common-test-code-for-timed-bailout">common test code for timed bailout</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Installation">Installation</a> <ul> <li> <a class="text-decoration-none" href="#compressed-man-pages">compressed man pages</a> </li> <li> <a class="text-decoration-none" href="#Make-Config.pm-cope-with-differences-between-build-and-installed-perl">Make Config.pm cope with differences between build and installed perl</a> </li> <li> <a class="text-decoration-none" href="#Relocatable-perl">Relocatable perl</a> </li> <li> <a class="text-decoration-none" href="#make-HTML-install-work">make HTML install work</a> </li> <li> <a class="text-decoration-none" href="#put-patchlevel-in-v">put patchlevel in -v</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Incremental-things">Incremental things</a> <ul> <li> <a class="text-decoration-none" href="#autovivification">autovivification</a> </li> <li> <a class="text-decoration-none" href="#fix-tainting-bugs">fix tainting bugs</a> </li> <li> <a class="text-decoration-none" href="#Make-tainting-consistent">Make tainting consistent</a> </li> <li> <a class="text-decoration-none" href="#Dual-life-everything">Dual life everything</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#Vague-things">Vague things</a> <ul> <li> <a class="text-decoration-none" href="#threads">threads</a> </li> <li> <a class="text-decoration-none" href="#POSIX-memory-footprint">POSIX memory footprint</a> </li> <li> <a class="text-decoration-none" href="#Optimize-away-@_">Optimize away @_</a> </li> <li> <a class="text-decoration-none" href="#switch-ops">switch ops</a> </li> <li> <a class="text-decoration-none" href="#Attach/detach-debugger-from-running-program">Attach/detach debugger from running program</a> </li> <li> <a class="text-decoration-none" href="#A-decent-benchmark">A decent benchmark</a> </li> <li> <a class="text-decoration-none" href="#readpipe(LIST)">readpipe(LIST)</a> </li> <li> <a class="text-decoration-none" href="#Self-ties">Self ties</a> </li> </ul> </li> </ul> <h1 id="NAME"><a class="permalink" href="#NAME">#</a>NAME</h1> <p>perltodo - Perl TO-DO List</p> <h1 id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">#</a>DESCRIPTION</h1> <p>This is a list of wishes for Perl. Send updates to <i>perl5-porters@perl.org</i>. If you want to work on any of these projects, be sure to check the perl5-porters archives for past ideas, flames, and propaganda. This will save you time and also prevent you from implementing something that Larry has already vetoed. One set of archives may be found at:</p> <pre><code class="plaintext">http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/</code></pre> <h1 id="assertions"><a class="permalink" href="#assertions">#</a>assertions</h1> <p>Clean up and finish support for assertions. See <a href="/5.8.7/assertions">assertions</a>.</p> <h1 id="iCOW"><a class="permalink" href="#iCOW">#</a>iCOW</h1> <p>Sarathy and Arthur have a proposal for an improved Copy On Write which specifically will be able to COW new ithreads. If this can be implemented it would be a good thing.</p> <h1 id="(?{...})-closures-in-regexps"><a class="permalink" href="#(?%7B...%7D)-closures-in-regexps">#</a><a id="closures-in-regexps"></a>(?{...}) closures in regexps</h1> <p>Fix (or rewrite) the implementation of the <code>/(?{...})/</code> closures.</p> <h1 id="A-re-entrant-regexp-engine"><a class="permalink" href="#A-re-entrant-regexp-engine">#</a><a id="A"></a>A re-entrant regexp engine</h1> <p>This will allow the use of a regex from inside (?{ }), (??{ }) and (?(?{ })|) constructs.</p> <h1 id="pragmata"><a class="permalink" href="#pragmata">#</a>pragmata</h1> <h2 id="lexical-pragmas"><a class="permalink" href="#lexical-pragmas">#</a><a id="lexical"></a>lexical pragmas</h2> <p>Reimplement the mechanism of lexical pragmas to be more extensible. Fix current pragmas that don't work well (or at all) with lexical scopes or in run-time eval(STRING) (<code>sort</code>, <code>re</code>, <code>encoding</code> for example). MJD has a preliminary patch that implements this.</p> <h2 id="use-less-'memory'"><a class="permalink" href="#use-less-'memory'">#</a><a id="use"></a><a id="use-less-memory"></a>use less 'memory'</h2> <p>Investigate trade offs to switch out perl's choices on memory usage. Particularly perl should be able to give memory back.</p> <h1 id="prototypes-and-functions"><a class="permalink" href="#prototypes-and-functions">#</a><a id="prototypes"></a>prototypes and functions</h1> <h2 id="_-prototype-character"><a class="permalink" href="#_-prototype-character">#</a><a id="_"></a><a id="prototype-character"></a>_ prototype character</h2> <p>Study the possibility of adding a new prototype character, <code>_</code>, meaning "this argument defaults to $_".</p> <h2 id="inlining-autoloaded-constants"><a class="permalink" href="#inlining-autoloaded-constants">#</a><a id="inlining"></a>inlining autoloaded constants</h2> <p>Currently the optimiser can inline constants when expressed as subroutines with prototype ($) that return a constant. Likewise, many packages wrapping C libraries export lots of constants as subroutines which are AUTOLOADed on demand. However, these have no prototypes, so can't be seen as constants by the optimiser. Some way of cheaply (low syntax, low memory overhead) to the perl compiler that a name is a constant would be great, so that it knows to call the AUTOLOAD routine at compile time, and then inline the constant.</p> <h2 id="Finish-off-lvalue-functions"><a class="permalink" href="#Finish-off-lvalue-functions">#</a><a id="Finish"></a>Finish off lvalue functions</h2> <p>The old perltodo notes "They don't work in the debugger, and they don't work for list or hash slices."</p> <h1 id="Unicode-and-UTF8"><a class="permalink" href="#Unicode-and-UTF8">#</a><a id="Unicode"></a>Unicode and UTF8</h1> <h2 id="Implicit-Latin-1-=>-Unicode-translation"><a class="permalink" href="#Implicit-Latin-1-=%3E-Unicode-translation">#</a><a id="Implicit"></a><a id="Implicit-Latin-1-Unicode-translation"></a>Implicit Latin 1 => Unicode translation</h2> <p>Conversions from byte strings to UTF-8 currently map high bit characters to Unicode without translation (or, depending on how you look at it, by implicitly assuming that the byte strings are in Latin-1). As perl assumes the C locale by default, upgrading a string to UTF-8 may change the meaning of its contents regarding character classes, case mapping, etc. This should probably emit a warning (at least).</p> <h2 id="UTF8-caching-code"><a class="permalink" href="#UTF8-caching-code">#</a><a id="UTF8"></a>UTF8 caching code</h2> <p>The string position/offset cache is not optional. It should be.</p> <h2 id="Unicode-in-Filenames"><a class="permalink" href="#Unicode-in-Filenames">#</a><a id="Unicode1"></a>Unicode in Filenames</h2> <p>chdir, chmod, chown, chroot, exec, glob, link, lstat, mkdir, open, opendir, qx, readdir, readlink, rename, rmdir, stat, symlink, sysopen, system, truncate, unlink, utime, -X. All these could potentially accept Unicode filenames either as input or output (and in the case of system and qx Unicode in general, as input or output to/from the shell). Whether a filesystem - an operating system pair understands Unicode in filenames varies.</p> <p>Known combinations that have some level of understanding include Microsoft NTFS, Apple HFS+ (In Mac OS 9 and X) and Apple UFS (in Mac OS X), NFS v4 is rumored to be Unicode, and of course Plan 9. How to create Unicode filenames, what forms of Unicode are accepted and used (UCS-2, UTF-16, UTF-8), what (if any) is the normalization form used, and so on, varies. Finding the right level of interfacing to Perl requires some thought. Remember that an OS does not implicate a filesystem.</p> <p>(The Windows -C command flag "wide API support" has been at least temporarily retired in 5.8.1, and the -C has been repurposed, see <a href="/5.8.7/perlrun">perlrun</a>.)</p> <h2 id="Unicode-in-%ENV"><a class="permalink" href="#Unicode-in-%25ENV">#</a><a id="Unicode2"></a><a id="Unicode-in-ENV"></a>Unicode in %ENV</h2> <p>Currently the %ENV entries are always byte strings.</p> <h1 id="Regexps"><a class="permalink" href="#Regexps">#</a>Regexps</h1> <h2 id="regexp-optimiser-optional"><a class="permalink" href="#regexp-optimiser-optional">#</a><a id="regexp"></a>regexp optimiser optional</h2> <p>The regexp optimiser is not optional. It should configurable to be, to allow its performance to be measured, and its bugs to be easily demonstrated.</p> <h1 id="POD"><a class="permalink" href="#POD">#</a>POD</h1> <h2 id="POD->-HTML-conversion-still-sucks"><a class="permalink" href="#POD-%3E-HTML-conversion-still-sucks">#</a><a id="POD1"></a><a id="POD---HTML-conversion-still-sucks"></a>POD -> HTML conversion still sucks</h2> <p>Which is crazy given just how simple POD purports to be, and how simple HTML can be.</p> <h1 id="Misc-medium-sized-projects"><a class="permalink" href="#Misc-medium-sized-projects">#</a><a id="Misc"></a>Misc medium sized projects</h1> <h2 id="UNITCHECK"><a class="permalink" href="#UNITCHECK">#</a>UNITCHECK</h2> <p>Introduce a new special block, UNITCHECK, which is run at the end of a compilation unit (module, file, eval(STRING) block). This will correspond to the Perl 6 CHECK. Perl 5's CHECK cannot be changed or removed because the O.pm/B.pm backend framework depends on it.</p> <h2 id="optional-optimizer"><a class="permalink" href="#optional-optimizer">#</a><a id="optional"></a>optional optimizer</h2> <p>Make the peephole optimizer optional.</p> <h2 id="You-WANT-*how*-many"><a class="permalink" href="#You-WANT-*how*-many">#</a><a id="You"></a><a id="You-WANT-how-many"></a>You WANT *how* many</h2> <p>Currently contexts are void, scalar and list. split has a special mechanism in place to pass in the number of return values wanted. It would be useful to have a general mechanism for this, backwards compatible and little speed hit. This would allow proposals such as short circuiting sort to be implemented as a module on CPAN.</p> <h2 id="lexical-aliases"><a class="permalink" href="#lexical-aliases">#</a><a id="lexical1"></a>lexical aliases</h2> <p>Allow lexical aliases (maybe via the syntax <code>my \$alias = \$foo</code>.</p> <h2 id="no-6"><a class="permalink" href="#no-6">#</a><a id="no"></a>no 6</h2> <p>Make <code>no 6</code> and <code>no v6</code> work (opposite of <code>use 5.005</code>, etc.).</p> <h2 id="IPv6"><a class="permalink" href="#IPv6">#</a>IPv6</h2> <p>Clean this up. Check everything in core works</p> <h2 id="entersub-XS-vs-Perl"><a class="permalink" href="#entersub-XS-vs-Perl">#</a><a id="entersub"></a>entersub XS vs Perl</h2> <p>At the moment pp_entersub is huge, and has code to deal with entering both perl and and XS subroutines. Subroutine implementations rarely change between perl and XS at run time, so investigate using 2 ops to enter subs (one for XS, one for perl) and swap between if a sub is redefined.</p> <h2 id="@INC-source-filter-to-Filter::Simple"><a class="permalink" href="#@INC-source-filter-to-Filter::Simple">#</a><a id="INC-source-filter-to-Filter::Simple"></a>@INC source filter to Filter::Simple</h2> <p>The second return value from a sub in @INC can be a source filter. This isn't documented. It should be changed to use Filter::Simple, tested and documented.</p> <h2 id="bincompat-functions"><a class="permalink" href="#bincompat-functions">#</a><a id="bincompat"></a>bincompat functions</h2> <p>There are lots of functions which are retained for binary compatibility. Clean these up. Move them to mathom.c, and don't compile for blead?</p> <h2 id="Use-fchown/fchmod-internally"><a class="permalink" href="#Use-fchown/fchmod-internally">#</a><a id="Use"></a><a id="Use-fchown-fchmod-internally"></a>Use fchown/fchmod internally</h2> <p>The old perltodo notes "This has been done in places, but needs a thorough code review. Also fchdir is available in some platforms."</p> <h2 id="Constant-folding"><a class="permalink" href="#Constant-folding">#</a><a id="Constant"></a>Constant folding</h2> <p>The peephole optimiser should trap errors during constant folding, and give up on the folding, rather than bailing out at compile time. It is quite possible that the unfoldable constant is in unreachable code, eg something akin to <code>$a = 0/0 if 0;</code></p> <h1 id="Tests"><a class="permalink" href="#Tests">#</a>Tests</h1> <h2 id="Make-Schwern-poorer"><a class="permalink" href="#Make-Schwern-poorer">#</a><a id="Make"></a>Make Schwern poorer</h2> <p>Tests for everything, At which point Schwern coughs up $500 to TPF.</p> <h2 id="test-B"><a class="permalink" href="#test-B">#</a><a id="test"></a>test B</h2> <p>A test suite for the B module would be nice.</p> <h2 id="common-test-code-for-timed-bailout"><a class="permalink" href="#common-test-code-for-timed-bailout">#</a><a id="common"></a>common test code for timed bailout</h2> <p>Write portable self destruct code for tests to stop them burning CPU in infinite loops. Needs to avoid using alarm, as some of the tests are testing alarm/sleep or timers.</p> <h1 id="Installation"><a class="permalink" href="#Installation">#</a>Installation</h1> <h2 id="compressed-man-pages"><a class="permalink" href="#compressed-man-pages">#</a><a id="compressed"></a>compressed man pages</h2> <p>Be able to install them</p> <h2 id="Make-Config.pm-cope-with-differences-between-build-and-installed-perl"><a class="permalink" href="#Make-Config.pm-cope-with-differences-between-build-and-installed-perl">#</a><a id="Make1"></a>Make Config.pm cope with differences between build and installed perl</h2> <h2 id="Relocatable-perl"><a class="permalink" href="#Relocatable-perl">#</a><a id="Relocatable"></a>Relocatable perl</h2> <p>Make it possible to create a relocatable perl binary. Will need some collusion with Config.pm. We could use a syntax of ... for location of current binary?</p> <h2 id="make-HTML-install-work"><a class="permalink" href="#make-HTML-install-work">#</a><a id="make"></a>make HTML install work</h2> <p>And look at the splitting of perlfunc in chunks. It needs fixing.</p> <h2 id="put-patchlevel-in-v"><a class="permalink" href="#put-patchlevel-in-v">#</a><a id="put"></a><a id="put-patchlevel-in--v"></a>put patchlevel in -v</h2> <p>Currently perl from p4/rsync ships with a patchlevel.h file that usually defines one local patch, of the form "MAINT12345" or "RC1". The output of perl -v doesn't report that a perl isn't an official release, and this information can get lost in bugs reports. Because of this, the minor version isn't bumped up until RC time, to minimise the possibility of versions of perl escaping that believe themselves to be newer than they actually are.</p> <p>It would be useful to find an elegant way to have the "this is an interim maintenance release" or "this is a release candidate" in the terse -v output, and have it so that it's easy for the pumpking to remove this just as the release tarball is rolled up. This way the version pulled out of rsync would always say "I'm a development release" and it would be safe to bump the reported minor version as soon as a release ships, which would aid perl developers.</p> <h1 id="Incremental-things"><a class="permalink" href="#Incremental-things">#</a><a id="Incremental"></a>Incremental things</h1> <p>Some tasks that don't need to get done in one big hit.</p> <h2 id="autovivification"><a class="permalink" href="#autovivification">#</a>autovivification</h2> <p>Make all autovivification consistent w.r.t LVALUE/RVALUE and strict/no strict;</p> <h2 id="fix-tainting-bugs"><a class="permalink" href="#fix-tainting-bugs">#</a><a id="fix"></a>fix tainting bugs</h2> <p>Fix the bugs revealed by running the test suite with the <code>-t</code> switch (via <code>make test.taintwarn</code>).</p> <h2 id="Make-tainting-consistent"><a class="permalink" href="#Make-tainting-consistent">#</a><a id="Make2"></a>Make tainting consistent</h2> <p>Tainting would be easier to use if it didn't take documented shortcuts and allow taint to "leak" everywhere within an expression.</p> <h2 id="Dual-life-everything"><a class="permalink" href="#Dual-life-everything">#</a><a id="Dual"></a>Dual life everything</h2> <p>As part of the "dists" plan, anything that doesn't belong in the smallest perl distribution needs to be dual lifed. Anything else can be too.</p> <h1 id="Vague-things"><a class="permalink" href="#Vague-things">#</a><a id="Vague"></a>Vague things</h1> <p>Some more nebulous ideas</p> <h2 id="threads"><a class="permalink" href="#threads">#</a>threads</h2> <p>Make threads more robust.</p> <h2 id="POSIX-memory-footprint"><a class="permalink" href="#POSIX-memory-footprint">#</a><a id="POSIX"></a>POSIX memory footprint</h2> <p>Ilya observed that use POSIX; eats memory like there's no tomorrow, and at various times worked to cut it down. There is probably still fat to cut out - for example POSIX passes Exporter some very memory hungry data structures.</p> <h2 id="Optimize-away-@_"><a class="permalink" href="#Optimize-away-@_">#</a><a id="Optimize"></a><a id="Optimize-away-_"></a>Optimize away @_</h2> <p>The old perltodo notes "Look at the "reification" code in <code>av.c</code>".</p> <h2 id="switch-ops"><a class="permalink" href="#switch-ops">#</a><a id="switch"></a>switch ops</h2> <p>The old perltodo notes "Although we have <code>Switch.pm</code> in core, Larry points to the dormant <code>nswitch</code> and <code>cswitch</code> ops in <i>pp.c</i>; using these opcodes would be much faster."</p> <h2 id="Attach/detach-debugger-from-running-program"><a class="permalink" href="#Attach/detach-debugger-from-running-program">#</a><a id="Attach"></a><a id="Attach-detach-debugger-from-running-program"></a>Attach/detach debugger from running program</h2> <p>The old perltodo notes "With <code>gdb</code>, you can attach the debugger to a running program if you pass the process ID. It would be good to do this with the Perl debugger on a running Perl program, although I'm not sure how it would be done." ssh and screen do this with named pipes in tmp. Maybe we can too.</p> <h2 id="A-decent-benchmark"><a class="permalink" href="#A-decent-benchmark">#</a><a id="A1"></a>A decent benchmark</h2> <p>perlbench seems impervious to any recent changes made to the perl core. It would be useful to have a reasonable general benchmarking suite that roughly represented what current perl programs do, and measurably reported whether tweaks to the core improve, degrade or don't really affect performance, to guide people attempting to optimise the guts of perl.</p> <h2 id="readpipe(LIST)"><a class="permalink" href="#readpipe(LIST)">#</a><a id="readpipe"></a><a id="readpipe-LIST"></a>readpipe(LIST)</h2> <p>system() accepts a LIST syntax (and a PROGRAM LIST syntax) to avoid running a shell. readpipe() (the function behind qx//) could be similarly extended.</p> <h2 id="Self-ties"><a class="permalink" href="#Self-ties">#</a><a id="Self"></a>Self ties</h2> <p>self ties are currently illegal because they caused too many segfaults. Maybe the causes of these could be tracked down and self-ties on all types re- instated.</p> </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>