Pod::Text - Convert POD data to formatted text

<!DOCTYPE html> <html lang="en-US"> <head> <title>Pod::Text - Convert POD data to formatted text - metacpan.org</title> <link rel="preload" as="fetch" href="/account/login_status" crossorigin="anonymous" /> <link href="/assets/style-XFEQ536G.css" rel="stylesheet" type="text/css"> <script src="/assets/main-WXBSEDQJ.js" type="module"></script> <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of podlators - MetaCPAN" href="/dist/podlators/releases.rss" /> <link rel="canonical" href="https://metacpan.org/pod/Pod::Text" /> <meta name="description" content="Convert POD data to formatted text" /> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5"> <link rel="shortcut icon" href="/static/icons/favicon.ico"> <link rel="apple-touch-icon" sizes="152x152" href="/static/icons/apple-touch-icon.png"> <link rel="search" href="/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN"> <script async src="https://perl-ads.perlhacks.com/perl-ads.js"></script> <script async src="https://www.googletagmanager.com/gtag/js?id=G-E82Q2V8LVD"></script> <meta property="og:site_name" content="MetaCPAN" /> <meta name="twitter:site" content="@metacpan" /> <meta property="og:type" content="article" /> <meta name="twitter:card" content="summary" /> <meta property="og:url" content="https://metacpan.org/pod/Pod::Text" /> <meta property="og:title" content="Pod::Text" /> <meta property="og:description" content="Convert POD data to formatted text" /> <meta property="og:image" content="https://metacpan.org/static/images/dots.png" /> </head> <body> <nav class="navbar navbar-default" role="navigation"> <div class="header-logo-large hidden-xs"> <a href="/" tabindex="0"> <svg class="logo" aria-label="MetaCPAN"> <use class="logo" href="/static/images/metacpan-logo.svg#logo" /> </svg> </a> </div> <div class="header-logo-icon visible-xs"> <a href="/"> <svg class="logo" aria-label="MetaCPAN"> <use class="logo" href="/static/images/metacpan-logo.svg#dots" /> </svg> </a> </div> <ul class="nav navbar-nav menu-items hidden-xs hidden-sm"> <li><a href="/about">About</a></li> <li><a href="/about/sponsors">Sponsor</a></li> <li><a href="https://grep.metacpan.org/">grep::cpan</a></li> <li><a href="/recent">Recent</a></li> <li><a href="/about/faq">FAQ</a></li> <li><a href="/tools">Tools</a></li> <li><a href="https://fastapi.metacpan.org/">API</a></li> </ul> <ul class="nav navbar-nav navbar-right"> <button type="button" class="searchbar-btn visible-xs visible-sm"> <i class="fa fa-search button-fa-icon"></i> </button> <form action="/search" class="searchbar-form visible-md visible-lg search-form form-horizontal"> <input type="hidden" name="size" id="metacpan_search-size" value="20"> <div class="form-group"> <div class="search-group"> <i class="fa fa-search"></i> <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value=""> </div> </div> </form> <li class="icon-slidepanel visible-xs visible-sm"> <button data-toggle="slidepanel" data-target=".slidepanel"> <span class="button-fa-icon"> <i class="fa fa-bars slidepanel-open"></i> <i class="fa fa-times slidepanel-close"></i> </span> </button> </li> <li class="dropdown login-dropdown show-logged-in"> <button type="button" class="dropdown-toggle" data-toggle="dropdown"> <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i> <i class="fas fa-chevron-down"></i> </button> <ul class="dropdown-menu"> <li><a href="/account/identities">Identities</a></li> <li><a href="/account/profile">Profile</a></li> <li><a href="/account/favorite/list">Favorites</a></li> <li> <a href="#" type="button" class="logout-button"> Logout </a> </li> </ul> </li> <li class="dropdown login-dropdown show-logged-out"> <button type="button" class="dropdown-toggle" data-toggle="dropdown"> <i class="fa fa-user button-fa-icon avatar-placeholder" aria-hidden="true"></i> <i class="fas fa-chevron-down"></i> </button> <ul class="dropdown-menu"> <li> <a href="/login/github"> <i class="fab fa-github fa-fw"></i> GitHub </a> </li> <li> <a href="/login/twitter"> <i class="fab fa-twitter fa-fw"></i> Twitter </a> </li> <li> <a href="/login/google"> <i class="fab fa-google fa-fw"></i> Google </a> </li> </ul> </li> <li class="dropdown login-dropdown hide-logged-in hide-logged-out"> <button> <i class="fa fa-user button-fa-icon" aria-hidden="true"></i> </button> </li> </ul> </nav> <div class="page-content "> <div id="perl-ad-target" class="top-notify-banner perl-ad-target"> </div> <nav class="sidebar"> <div class="slidepanel"> <ul class="nav-list "> <li class="nav-header no-margin-top"> <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of podlators was released."> <span class="relatize">14 Jul 2024 19:58:09 UTC</span> </div> </li> <li> Distribution: <a href="/dist/podlators">podlators</a> </li> <li> Module version: v6.0.2 </li> <li> <a data-keyboard-shortcut="g s" href="/dist/podlators/source/lib/Pod/Text.pm">Source</a> (<a href="/dist/podlators/source/lib/Pod/Text.pm?raw=1">raw</a>) </li> <li> <a data-keyboard-shortcut="g b" href="/dist/podlators/source/lib/Pod">Browse</a> (<a href="/dist/podlators/source/lib/Pod?raw=1">raw</a>) </li> <li> <a data-keyboard-shortcut="g c" href="/dist/podlators/changes">Changes</a> </li> <li> <a rel="noopener nofollow" class="nopopup" href="https://www.eyrie.org/~eagle/software/podlators/">Homepage</a> </li> <li> <a class="nopopup" href="/dist/podlators/contribute">How to Contribute</a> </li> <li> <a rel="noopener nofollow" data-keyboard-shortcut="g r" href="https://github.com/rra/podlators">Repository</a> </li> <li> <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://github.com/rra/podlators/issues">Issues</a> (2) </li> <li> <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=podlators+v6.0.2" title="Matrix">Testers</a> </li> <li> <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/RRA/podlators-v6.0.2">Kwalitee</a> </li> <li> <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on podlators who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)"> Bus factor: 5 </div> </li> <li> License: perl_5 </li> <li> Perl: v5.12.0 </li> <li class="nav-header">Activity</li> <li> <div class="activity-graph"> <img src="/dist/podlators/activity.svg?res=month" /> <div class="comment">24 month</div> </div> </li> <li class="nav-header">Tools</li> <li> <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/R/RR/RRA/podlators-v6.0.2.tar.gz"> Download (<span itemprop="fileSize">152.13KB</span>)</a> </li> <li> <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FRRA%2Fpodlators-v6.0.2%2Flib%2FPod%2FText.pm"> MetaCPAN Explorer </a> </li> <li> <a href="/dist/podlators/permissions"> Permissions </a> </li> <li> <a href="/dist/podlators/releases.rss"> Subscribe to distribution </a> </li> <li> <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog"> Install Instructions </button> </li> <li> <form action="/search"> <input type="hidden" name="q" value="dist:podlators"> <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form"> <input type="submit" style="display: none"> </form> </li> <li> <form action="https://grep.metacpan.org/search"> <input type="hidden" name="qd" value="podlators"> <input type="hidden" name="source" value="metacpan"> <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form"> <input type="submit" style="display: none"> </form> </li> <li class="version-jump"> <select class="select-navigator form-control tool-bar-form"> <option disabled selected>Jump to version</option> <option disabled value="/release/RRA/podlators-v6.0.2/view/lib/Pod/Text.pm" >v6.0.2 (RRA on 2024-07-14)</option> <option value="/release/RRA/podlators-v6.0.1/view/lib/Pod/Text.pm" >v6.0.1 (RRA on 2024-07-13)</option> <option value="/release/RRA/podlators-v6.0.0/view/lib/Pod/Text.pm" >v6.0.0 (RRA on 2024-07-11)</option> <option value="/release/RRA/podlators-5.01/view/lib/Pod/Text.pm" >5.01 (RRA on 2022-12-25)</option> <option value="/release/RRA/podlators-4.14/view/lib/Pod/Text.pm" >4.14 (RRA on 2020-01-04)</option> <optgroup label="BackPAN">' <option value="/release/RRA/podlators-5.00/view/lib/Pod/Text.pm" >5.00 (RRA on 2022-11-25)</option> <option value="/release/RRA/podlators-4.13/view/lib/Pod/Text.pm" >4.13 (RRA on 2019-12-26)</option> <option value="/release/RRA/podlators-4.12/view/lib/Pod/Text.pm" >4.12 (RRA on 2019-06-01)</option> <option value="/release/RRA/podlators-4.11/view/lib/Pod/Text.pm" >4.11 (RRA on 2018-05-07)</option> <option value="/release/RRA/podlators-4.10/view/lib/Pod/Text.pm" >4.10 (RRA on 2017-12-25)</option> <option value="/release/RRA/podlators-4.09/view/lib/Pod/Text.pm" >4.09 (RRA on 2016-11-05)</option> <option value="/release/RRA/podlators-4.08/view/lib/Pod/Text.pm" >4.08 (RRA on 2016-09-25)</option> <option value="/release/RRA/podlators-4.07/view/lib/Pod/Text.pm" >4.07 (RRA on 2016-03-21)</option> <option value="/release/RRA/podlators-4.06/view/lib/Pod/Text.pm" >4.06 (RRA on 2016-02-01)</option> <option value="/release/RRA/podlators-4.05/view/lib/Pod/Text.pm" >4.05 (RRA on 2016-01-16)</option> <option value="/release/RRA/podlators-4.04/view/lib/Pod/Text.pm" >4.04 (RRA on 2016-01-03)</option> <option value="/release/RRA/podlators-4.03/view/lib/Pod/Text.pm" >4.03 (RRA on 2015-12-06)</option> <option value="/release/RRA/podlators-4.02/view/lib/Pod/Text.pm" >4.02 (RRA on 2015-12-03)</option> <option value="/release/RRA/podlators-2.5.3/view/lib/Pod/Text.pm" >2.5.3 (RRA on 2013-10-06)</option> <option value="/release/RRA/podlators-2.5.2/view/lib/Pod/Text.pm" >2.5.2 (RRA on 2013-09-22)</option> <option value="/release/RRA/podlators-2.5.1/view/lib/Pod/Text.pm" >2.5.1 (RRA on 2013-02-28)</option> <option value="/release/RRA/podlators-2.5.0/view/lib/Pod/Text.pm" >2.5.0 (RRA on 2013-01-02)</option> <option value="/release/RRA/podlators-2.4.2/view/lib/Pod/Text.pm" >2.4.2 (RRA on 2012-06-01)</option> <option value="/release/RRA/podlators-2.4.1/view/lib/Pod/Text.pm" >2.4.1 (RRA on 2012-05-30)</option> <option value="/release/RRA/podlators-2.4.0/view/lib/Pod/Text.pm" >2.4.0 (RRA on 2010-10-11)</option> <option value="/release/RRA/podlators-2.3.1/view/lib/Pod/Text.pm" >2.3.1 (RRA on 2010-02-18)</option> <option value="/release/RRA/podlators-2.3.0/view/lib/Pod/Text.pm" >2.3.0 (RRA on 2009-12-29)</option> <option value="/release/RRA/podlators-2.2.2/view/lib/Pod/Text.pm" >2.2.2 (RRA on 2009-01-18)</option> <option value="/release/RRA/podlators-2.2.1/view/lib/Pod/Text.pm" >2.2.1 (RRA on 2008-12-20)</option> <option value="/release/RRA/podlators-2.2.0/view/lib/Pod/Text.pm" >2.2.0 (RRA on 2008-10-05)</option> <option value="/release/RRA/podlators-2.1.4/view/lib/Pod/Text.pm" >2.1.4 (RRA on 2008-09-22)</option> <option value="/release/RRA/podlators-2.1.3/view/lib/Pod/Text.pm" >2.1.3 (RRA on 2008-09-14)</option> <option value="/release/RRA/podlators-2.1.2/view/lib/Pod/Text.pm" >2.1.2 (RRA on 2008-07-21)</option> <option value="/release/RRA/podlators-2.1.1/view/lib/Pod/Text.pm" >2.1.1 (RRA on 2008-07-04)</option> <option value="/release/RRA/podlators-2.1.0/view/lib/Pod/Text.pm" >2.1.0 (RRA on 2008-06-02)</option> <option value="/release/RRA/podlators-2.0.6/view/lib/Pod/Text.pm" >2.0.6 (RRA on 2007-11-29)</option> <option value="/release/RRA/podlators-2.0.5/view/lib/Pod/Text.pm" >2.0.5 (RRA on 2006-09-16)</option> <option value="/release/RRA/podlators-2.0.4/view/lib/Pod/Text.pm" >2.0.4 (RRA on 2006-02-19)</option> <option value="/release/RRA/podlators-2.0.3/view/lib/Pod/Text.pm" >2.0.3 (RRA on 2006-01-28)</option> <option value="/release/RRA/podlators-2.0.2/view/lib/Pod/Text.pm" >2.0.2 (RRA on 2006-01-26)</option> <option value="/release/RRA/podlators-2.0.1/view/lib/Pod/Text.pm" >2.0.1 (RRA on 2006-01-21)</option> <option value="/release/RRA/podlators-2.00/view/lib/Pod/Text.pm" >2.00 (RRA on 2005-11-29)</option> <option value="/release/RRA/podlators-1.27/view/lib/Pod/Text.pm" >1.27 (RRA on 2003-07-09)</option> <option value="/release/RRA/podlators-1.26/view/lib/Pod/Text.pm" >1.26 (RRA on 2003-03-30)</option> <option value="/release/RRA/podlators-1.25/view/lib/Pod/Text.pm" >1.25 (RRA on 2003-01-05)</option> <option value="/release/RRA/podlators-1.24/view/lib/Pod/Text.pm" >1.24 (RRA on 2002-08-04)</option> <option value="/release/RRA/podlators-1.23/view/lib/Pod/Text.pm" >1.23 (RRA on 2002-07-15)</option> <option value="/release/RRA/podlators-1.22/view/lib/Pod/Text.pm" >1.22 (RRA on 2002-06-23)</option> <option value="/release/RRA/podlators-1.21/view/lib/Pod/Text.pm" >1.21 (RRA on 2002-02-17)</option> <option value="/release/RRA/podlators-1.20/view/lib/Pod/Text.pm" >1.20 (RRA on 2002-01-28)</option> <option value="/release/RRA/podlators-1.19/view/lib/Pod/Text.pm" >1.19 (RRA on 2002-01-02)</option> <option value="/release/RRA/podlators-1.18/view/lib/Pod/Text.pm" >1.18 (RRA on 2001-12-01)</option> <option value="/release/RRA/podlators-1.17/view/lib/Pod/Text.pm" >1.17 (RRA on 2001-11-28)</option> <option value="/release/RRA/podlators-1.16/view/lib/Pod/Text.pm" >1.16 (RRA on 2001-11-26)</option> <option value="/release/RRA/podlators-1.15/view/lib/Pod/Text.pm" >1.15 (RRA on 2001-11-26)</option> <option value="/release/RRA/podlators-1.14/view/lib/Pod/Text.pm" >1.14 (RRA on 2001-11-23)</option> <option value="/release/RRA/podlators-1.13/view/lib/Pod/Text.pm" >1.13 (RRA on 2001-11-15)</option> <option value="/release/RRA/podlators-1.12/view/lib/Pod/Text.pm" >1.12 (RRA on 2001-11-15)</option> <option value="/release/RRA/podlators-1.11/view/lib/Pod/Text.pm" >1.11 (RRA on 2001-10-20)</option> <option value="/release/RRA/podlators-1.10/view/lib/Pod/Text.pm" >1.10 (RRA on 2001-07-10)</option> <option value="/release/RRA/podlators-1.09/view/lib/Pod/Text.pm" >1.09 (RRA on 2001-04-09)</option> <option value="/release/RRA/podlators-1.08/view/lib/Pod/Text.pm" >1.08 (RRA on 2001-02-10)</option> <option value="/release/RRA/podlators-1.07/view/lib/Pod/Text.pm" >1.07 (RRA on 2001-01-16)</option> <option value="/release/RRA/podlators-1.06/view/lib/Pod/Text.pm" >1.06 (RRA on 2000-12-25)</option> <option value="/release/RRA/podlators-1.05/view/lib/Pod/Text.pm" >1.05 (RRA on 2000-11-19)</option> <option value="/release/RRA/podlators-1.04/view/lib/Pod/Text.pm" >1.04 (RRA on 2000-10-10)</option> <option value="/release/RRA/podlators-1.03/view/lib/Pod/Text.pm" >1.03 (RRA on 2000-09-03)</option> <option value="/release/RRA/podlators-1.02/view/lib/Pod/Text.pm" >1.02 (RRA on 2000-04-26)</option> <option value="/release/RRA/podlators-1.01/view/lib/Pod/Text.pm" >1.01 (RRA on 2000-03-31)</option> <option value="/release/RRA/podlators-1.00/view/lib/Pod/Text.pm" >1.00 (RRA on 2000-03-17)</option> <option value="/release/RRA/podlators-0.08/view/lib/Pod/Text.pm" >0.08 (RRA on 1999-10-07)</option> <option value="/release/RRA/podlators-0.07/view/lib/Pod/Text.pm" >0.07 (RRA on 1999-09-25)</option> <option value="/release/RRA/podlators-0.06/view/lib/Pod/Text.pm" >0.06 (RRA on 1999-09-21)</option> <option value="/release/RRA/podlators-0.02/view/lib/Pod/Text.pm" >0.02 (RRA on 1999-07-29)</option> </optgroup> </select> </li> <li class="version-diff"> <select class="select-navigator form-control tool-bar-form"> <option disabled selected>Diff with version</option> <option disabled value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-v6.0.2/lib/Pod/Text.pm" >v6.0.2 (RRA on 2024-07-14)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-v6.0.1/lib/Pod/Text.pm" >v6.0.1 (RRA on 2024-07-13)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-v6.0.0/lib/Pod/Text.pm" >v6.0.0 (RRA on 2024-07-11)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-5.01/lib/Pod/Text.pm" >5.01 (RRA on 2022-12-25)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.14/lib/Pod/Text.pm" >4.14 (RRA on 2020-01-04)</option> <optgroup label="BackPAN">' <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-5.00/lib/Pod/Text.pm" >5.00 (RRA on 2022-11-25)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.13/lib/Pod/Text.pm" >4.13 (RRA on 2019-12-26)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.12/lib/Pod/Text.pm" >4.12 (RRA on 2019-06-01)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.11/lib/Pod/Text.pm" >4.11 (RRA on 2018-05-07)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.10/lib/Pod/Text.pm" >4.10 (RRA on 2017-12-25)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.09/lib/Pod/Text.pm" >4.09 (RRA on 2016-11-05)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.08/lib/Pod/Text.pm" >4.08 (RRA on 2016-09-25)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.07/lib/Pod/Text.pm" >4.07 (RRA on 2016-03-21)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.06/lib/Pod/Text.pm" >4.06 (RRA on 2016-02-01)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.05/lib/Pod/Text.pm" >4.05 (RRA on 2016-01-16)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.04/lib/Pod/Text.pm" >4.04 (RRA on 2016-01-03)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.03/lib/Pod/Text.pm" >4.03 (RRA on 2015-12-06)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-4.02/lib/Pod/Text.pm" >4.02 (RRA on 2015-12-03)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.5.3/lib/Pod/Text.pm" >2.5.3 (RRA on 2013-10-06)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.5.2/lib/Pod/Text.pm" >2.5.2 (RRA on 2013-09-22)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.5.1/lib/Pod/Text.pm" >2.5.1 (RRA on 2013-02-28)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.5.0/lib/Pod/Text.pm" >2.5.0 (RRA on 2013-01-02)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.4.2/lib/Pod/Text.pm" >2.4.2 (RRA on 2012-06-01)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.4.1/lib/Pod/Text.pm" >2.4.1 (RRA on 2012-05-30)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.4.0/lib/Pod/Text.pm" >2.4.0 (RRA on 2010-10-11)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.3.1/lib/Pod/Text.pm" >2.3.1 (RRA on 2010-02-18)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.3.0/lib/Pod/Text.pm" >2.3.0 (RRA on 2009-12-29)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.2.2/lib/Pod/Text.pm" >2.2.2 (RRA on 2009-01-18)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.2.1/lib/Pod/Text.pm" >2.2.1 (RRA on 2008-12-20)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.2.0/lib/Pod/Text.pm" >2.2.0 (RRA on 2008-10-05)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.1.4/lib/Pod/Text.pm" >2.1.4 (RRA on 2008-09-22)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.1.3/lib/Pod/Text.pm" >2.1.3 (RRA on 2008-09-14)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.1.2/lib/Pod/Text.pm" >2.1.2 (RRA on 2008-07-21)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.1.1/lib/Pod/Text.pm" >2.1.1 (RRA on 2008-07-04)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.1.0/lib/Pod/Text.pm" >2.1.0 (RRA on 2008-06-02)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.0.6/lib/Pod/Text.pm" >2.0.6 (RRA on 2007-11-29)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.0.5/lib/Pod/Text.pm" >2.0.5 (RRA on 2006-09-16)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.0.4/lib/Pod/Text.pm" >2.0.4 (RRA on 2006-02-19)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.0.3/lib/Pod/Text.pm" >2.0.3 (RRA on 2006-01-28)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.0.2/lib/Pod/Text.pm" >2.0.2 (RRA on 2006-01-26)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.0.1/lib/Pod/Text.pm" >2.0.1 (RRA on 2006-01-21)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-2.00/lib/Pod/Text.pm" >2.00 (RRA on 2005-11-29)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.27/lib/Pod/Text.pm" >1.27 (RRA on 2003-07-09)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.26/lib/Pod/Text.pm" >1.26 (RRA on 2003-03-30)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.25/lib/Pod/Text.pm" >1.25 (RRA on 2003-01-05)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.24/lib/Pod/Text.pm" >1.24 (RRA on 2002-08-04)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.23/lib/Pod/Text.pm" >1.23 (RRA on 2002-07-15)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.22/lib/Pod/Text.pm" >1.22 (RRA on 2002-06-23)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.21/lib/Pod/Text.pm" >1.21 (RRA on 2002-02-17)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.20/lib/Pod/Text.pm" >1.20 (RRA on 2002-01-28)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.19/lib/Pod/Text.pm" >1.19 (RRA on 2002-01-02)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.18/lib/Pod/Text.pm" >1.18 (RRA on 2001-12-01)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.17/lib/Pod/Text.pm" >1.17 (RRA on 2001-11-28)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.16/lib/Pod/Text.pm" >1.16 (RRA on 2001-11-26)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.15/lib/Pod/Text.pm" >1.15 (RRA on 2001-11-26)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.14/lib/Pod/Text.pm" >1.14 (RRA on 2001-11-23)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.13/lib/Pod/Text.pm" >1.13 (RRA on 2001-11-15)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.12/lib/Pod/Text.pm" >1.12 (RRA on 2001-11-15)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.11/lib/Pod/Text.pm" >1.11 (RRA on 2001-10-20)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.10/lib/Pod/Text.pm" >1.10 (RRA on 2001-07-10)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.09/lib/Pod/Text.pm" >1.09 (RRA on 2001-04-09)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.08/lib/Pod/Text.pm" >1.08 (RRA on 2001-02-10)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.07/lib/Pod/Text.pm" >1.07 (RRA on 2001-01-16)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.06/lib/Pod/Text.pm" >1.06 (RRA on 2000-12-25)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.05/lib/Pod/Text.pm" >1.05 (RRA on 2000-11-19)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.04/lib/Pod/Text.pm" >1.04 (RRA on 2000-10-10)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.03/lib/Pod/Text.pm" >1.03 (RRA on 2000-09-03)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.02/lib/Pod/Text.pm" >1.02 (RRA on 2000-04-26)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.01/lib/Pod/Text.pm" >1.01 (RRA on 2000-03-31)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-1.00/lib/Pod/Text.pm" >1.00 (RRA on 2000-03-17)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-0.08/lib/Pod/Text.pm" >0.08 (RRA on 1999-10-07)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-0.07/lib/Pod/Text.pm" >0.07 (RRA on 1999-09-25)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-0.06/lib/Pod/Text.pm" >0.06 (RRA on 1999-09-21)</option> <option value="/release/RRA/podlators-v6.0.2/diff/RRA/podlators-0.02/lib/Pod/Text.pm" >0.02 (RRA on 1999-07-29)</option> </optgroup> </select> </li> <li> <ul class="dependencies"> <li class="nav-header">Dependencies</li> <li><a href="/pod/Pod::Simple" title="Pod::Simple" class="ellipsis">Pod::Simple</a></li> <li><i class="ttip" title="dynamic_config enabled">and possibly others</i></li> <li> <hr> </li> <li> <a href="/module/Pod::Text/requires">Reverse dependencies</a> </li> <li> <a href="http://deps.cpantesters.org/?module=Pod%3A%3AText">CPAN Testers List</a> </li> <li> <a href="https://cpandeps.grinnz.com/?dist=podlators">Dependency graph</a> </li> </ul> </li> <li class="nav-header">Permalinks</li> <li> <a href="/release/RRA/podlators-v6.0.2/view/lib/Pod/Text.pm">This version</a> </li> <li> <a href="/pod/Pod::Text">Latest version</a> </li> <li> <div class="plussers"> <div class="nav-header">++ed by:</div> <div> <a class="display-all" href="/author/KEEDI"><img src="https://www.gravatar.com/avatar/95f905a7a4ccc573c711e9d264c0fde8?d=identicon&s=20" title="KEEDI" alt="KEEDI"></a> <a class="display-all" href="/author/MFZZ"><img src="https://www.gravatar.com/avatar/0f2eaa76d2775840f2ca64befbb2c87c?d=identicon&s=20" title="MFZZ" alt="MFZZ"></a> <a class="display-all" href="/author/ADAMJS"><img src="https://www.gravatar.com/avatar/62c7b6e864d6509cff5839543c676614?d=identicon&s=20" title="ADAMJS" alt="ADAMJS"></a> <a class="display-all" href="/author/DELON"><img src="https://www.gravatar.com/avatar/8a316157de5eaa39f351b1725c4641d0?d=identicon&s=20" title="DELON" alt="DELON"></a> <a class="display-all" href="/author/PINGAN"><img src="https://www.gravatar.com/avatar/a02222e5e0e4fd24d52fc29a08ac6bcb?d=identicon&s=20" title="PINGAN" alt="PINGAN"></a> </div>  <div> <a href="/dist/podlators/plussers">8 PAUSE users</a> </div> <div> 6 non-PAUSE users </div> </div> </li> <li> </li> </ul> </div> </nav> <div class="content-navigation"> <div class="breadcrumbs"> <span> <a data-keyboard-shortcut="g a" rel="author" href="/author/RRA" class="author-name">Russ Allbery</a> </span> <span> / </span> <div class="release dist-release status-latest maturity-released"> <span class="dropdown"><b class="caret"></b></span> <select class="select-navigator "> <option selected value="/release/RRA/podlators-v6.0.2/view/lib/Pod/Text.pm" >v6.0.2 (RRA on 2024-07-14)</option> <option value="/release/RRA/podlators-v6.0.1/view/lib/Pod/Text.pm" >v6.0.1 (RRA on 2024-07-13)</option> <option value="/release/RRA/podlators-v6.0.0/view/lib/Pod/Text.pm" >v6.0.0 (RRA on 2024-07-11)</option> <option value="/release/RRA/podlators-5.01/view/lib/Pod/Text.pm" >5.01 (RRA on 2022-12-25)</option> <option value="/release/RRA/podlators-4.14/view/lib/Pod/Text.pm" >4.14 (RRA on 2020-01-04)</option> <optgroup label="BackPAN">' <option value="/release/RRA/podlators-5.00/view/lib/Pod/Text.pm" >5.00 (RRA on 2022-11-25)</option> <option value="/release/RRA/podlators-4.13/view/lib/Pod/Text.pm" >4.13 (RRA on 2019-12-26)</option> <option value="/release/RRA/podlators-4.12/view/lib/Pod/Text.pm" >4.12 (RRA on 2019-06-01)</option> <option value="/release/RRA/podlators-4.11/view/lib/Pod/Text.pm" >4.11 (RRA on 2018-05-07)</option> <option value="/release/RRA/podlators-4.10/view/lib/Pod/Text.pm" >4.10 (RRA on 2017-12-25)</option> <option value="/release/RRA/podlators-4.09/view/lib/Pod/Text.pm" >4.09 (RRA on 2016-11-05)</option> <option value="/release/RRA/podlators-4.08/view/lib/Pod/Text.pm" >4.08 (RRA on 2016-09-25)</option> <option value="/release/RRA/podlators-4.07/view/lib/Pod/Text.pm" >4.07 (RRA on 2016-03-21)</option> <option value="/release/RRA/podlators-4.06/view/lib/Pod/Text.pm" >4.06 (RRA on 2016-02-01)</option> <option value="/release/RRA/podlators-4.05/view/lib/Pod/Text.pm" >4.05 (RRA on 2016-01-16)</option> <option value="/release/RRA/podlators-4.04/view/lib/Pod/Text.pm" >4.04 (RRA on 2016-01-03)</option> <option value="/release/RRA/podlators-4.03/view/lib/Pod/Text.pm" >4.03 (RRA on 2015-12-06)</option> <option value="/release/RRA/podlators-4.02/view/lib/Pod/Text.pm" >4.02 (RRA on 2015-12-03)</option> <option value="/release/RRA/podlators-2.5.3/view/lib/Pod/Text.pm" >2.5.3 (RRA on 2013-10-06)</option> <option value="/release/RRA/podlators-2.5.2/view/lib/Pod/Text.pm" >2.5.2 (RRA on 2013-09-22)</option> <option value="/release/RRA/podlators-2.5.1/view/lib/Pod/Text.pm" >2.5.1 (RRA on 2013-02-28)</option> <option value="/release/RRA/podlators-2.5.0/view/lib/Pod/Text.pm" >2.5.0 (RRA on 2013-01-02)</option> <option value="/release/RRA/podlators-2.4.2/view/lib/Pod/Text.pm" >2.4.2 (RRA on 2012-06-01)</option> <option value="/release/RRA/podlators-2.4.1/view/lib/Pod/Text.pm" >2.4.1 (RRA on 2012-05-30)</option> <option value="/release/RRA/podlators-2.4.0/view/lib/Pod/Text.pm" >2.4.0 (RRA on 2010-10-11)</option> <option value="/release/RRA/podlators-2.3.1/view/lib/Pod/Text.pm" >2.3.1 (RRA on 2010-02-18)</option> <option value="/release/RRA/podlators-2.3.0/view/lib/Pod/Text.pm" >2.3.0 (RRA on 2009-12-29)</option> <option value="/release/RRA/podlators-2.2.2/view/lib/Pod/Text.pm" >2.2.2 (RRA on 2009-01-18)</option> <option value="/release/RRA/podlators-2.2.1/view/lib/Pod/Text.pm" >2.2.1 (RRA on 2008-12-20)</option> <option value="/release/RRA/podlators-2.2.0/view/lib/Pod/Text.pm" >2.2.0 (RRA on 2008-10-05)</option> <option value="/release/RRA/podlators-2.1.4/view/lib/Pod/Text.pm" >2.1.4 (RRA on 2008-09-22)</option> <option value="/release/RRA/podlators-2.1.3/view/lib/Pod/Text.pm" >2.1.3 (RRA on 2008-09-14)</option> <option value="/release/RRA/podlators-2.1.2/view/lib/Pod/Text.pm" >2.1.2 (RRA on 2008-07-21)</option> <option value="/release/RRA/podlators-2.1.1/view/lib/Pod/Text.pm" >2.1.1 (RRA on 2008-07-04)</option> <option value="/release/RRA/podlators-2.1.0/view/lib/Pod/Text.pm" >2.1.0 (RRA on 2008-06-02)</option> <option value="/release/RRA/podlators-2.0.6/view/lib/Pod/Text.pm" >2.0.6 (RRA on 2007-11-29)</option> <option value="/release/RRA/podlators-2.0.5/view/lib/Pod/Text.pm" >2.0.5 (RRA on 2006-09-16)</option> <option value="/release/RRA/podlators-2.0.4/view/lib/Pod/Text.pm" >2.0.4 (RRA on 2006-02-19)</option> <option value="/release/RRA/podlators-2.0.3/view/lib/Pod/Text.pm" >2.0.3 (RRA on 2006-01-28)</option> <option value="/release/RRA/podlators-2.0.2/view/lib/Pod/Text.pm" >2.0.2 (RRA on 2006-01-26)</option> <option value="/release/RRA/podlators-2.0.1/view/lib/Pod/Text.pm" >2.0.1 (RRA on 2006-01-21)</option> <option value="/release/RRA/podlators-2.00/view/lib/Pod/Text.pm" >2.00 (RRA on 2005-11-29)</option> <option value="/release/RRA/podlators-1.27/view/lib/Pod/Text.pm" >1.27 (RRA on 2003-07-09)</option> <option value="/release/RRA/podlators-1.26/view/lib/Pod/Text.pm" >1.26 (RRA on 2003-03-30)</option> <option value="/release/RRA/podlators-1.25/view/lib/Pod/Text.pm" >1.25 (RRA on 2003-01-05)</option> <option value="/release/RRA/podlators-1.24/view/lib/Pod/Text.pm" >1.24 (RRA on 2002-08-04)</option> <option value="/release/RRA/podlators-1.23/view/lib/Pod/Text.pm" >1.23 (RRA on 2002-07-15)</option> <option value="/release/RRA/podlators-1.22/view/lib/Pod/Text.pm" >1.22 (RRA on 2002-06-23)</option> <option value="/release/RRA/podlators-1.21/view/lib/Pod/Text.pm" >1.21 (RRA on 2002-02-17)</option> <option value="/release/RRA/podlators-1.20/view/lib/Pod/Text.pm" >1.20 (RRA on 2002-01-28)</option> <option value="/release/RRA/podlators-1.19/view/lib/Pod/Text.pm" >1.19 (RRA on 2002-01-02)</option> <option value="/release/RRA/podlators-1.18/view/lib/Pod/Text.pm" >1.18 (RRA on 2001-12-01)</option> <option value="/release/RRA/podlators-1.17/view/lib/Pod/Text.pm" >1.17 (RRA on 2001-11-28)</option> <option value="/release/RRA/podlators-1.16/view/lib/Pod/Text.pm" >1.16 (RRA on 2001-11-26)</option> <option value="/release/RRA/podlators-1.15/view/lib/Pod/Text.pm" >1.15 (RRA on 2001-11-26)</option> <option value="/release/RRA/podlators-1.14/view/lib/Pod/Text.pm" >1.14 (RRA on 2001-11-23)</option> <option value="/release/RRA/podlators-1.13/view/lib/Pod/Text.pm" >1.13 (RRA on 2001-11-15)</option> <option value="/release/RRA/podlators-1.12/view/lib/Pod/Text.pm" >1.12 (RRA on 2001-11-15)</option> <option value="/release/RRA/podlators-1.11/view/lib/Pod/Text.pm" >1.11 (RRA on 2001-10-20)</option> <option value="/release/RRA/podlators-1.10/view/lib/Pod/Text.pm" >1.10 (RRA on 2001-07-10)</option> <option value="/release/RRA/podlators-1.09/view/lib/Pod/Text.pm" >1.09 (RRA on 2001-04-09)</option> <option value="/release/RRA/podlators-1.08/view/lib/Pod/Text.pm" >1.08 (RRA on 2001-02-10)</option> <option value="/release/RRA/podlators-1.07/view/lib/Pod/Text.pm" >1.07 (RRA on 2001-01-16)</option> <option value="/release/RRA/podlators-1.06/view/lib/Pod/Text.pm" >1.06 (RRA on 2000-12-25)</option> <option value="/release/RRA/podlators-1.05/view/lib/Pod/Text.pm" >1.05 (RRA on 2000-11-19)</option> <option value="/release/RRA/podlators-1.04/view/lib/Pod/Text.pm" >1.04 (RRA on 2000-10-10)</option> <option value="/release/RRA/podlators-1.03/view/lib/Pod/Text.pm" >1.03 (RRA on 2000-09-03)</option> <option value="/release/RRA/podlators-1.02/view/lib/Pod/Text.pm" >1.02 (RRA on 2000-04-26)</option> <option value="/release/RRA/podlators-1.01/view/lib/Pod/Text.pm" >1.01 (RRA on 2000-03-31)</option> <option value="/release/RRA/podlators-1.00/view/lib/Pod/Text.pm" >1.00 (RRA on 2000-03-17)</option> <option value="/release/RRA/podlators-0.08/view/lib/Pod/Text.pm" >0.08 (RRA on 1999-10-07)</option> <option value="/release/RRA/podlators-0.07/view/lib/Pod/Text.pm" >0.07 (RRA on 1999-09-25)</option> <option value="/release/RRA/podlators-0.06/view/lib/Pod/Text.pm" >0.06 (RRA on 1999-09-21)</option> <option value="/release/RRA/podlators-0.02/view/lib/Pod/Text.pm" >0.02 (RRA on 1999-07-29)</option> </optgroup> </select> <a data-keyboard-shortcut="g d" class="release-name" href="/dist/podlators">podlators-v6.0.2</a> </div> <span class="river-gauge-gauge"> <svg width="24px" height="15px" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"> <g> <title> River stage five 
 • 66 direct dependents 
 • 33320 total dependents </title> <rect x="0" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="5" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="10" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="15" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="20" y="0" width="4" height="15" fill="#7ea3f2" /> </g> </svg> </span> <div id="podlators-fav" class="show-logged-in"> <form action="/account/favorite/add" style="display: inline" method="POST"> <input type="hidden" name="remove" value="0"> <input type="hidden" name="release" value="podlators-v6.0.2"> <input type="hidden" name="author" value="RRA"> <input type="hidden" name="distribution" value="podlators"> <button type="submit" class="favorite highlight"><span>14</span> ++</button> </form> </div> <div class="show-logged-out"> <button class="fav-not-logged-in favorite highlight"><span>14</span> ++</button> </div> / <span>Pod::Text</span> </div> </div> <main class="content"> <nav class="toc"> <div class="toc-header"><strong>Contents</strong></div> <ul> <li><a href="#NAME">NAME</a></li> <li><a href="#SYNOPSIS">SYNOPSIS</a></li> <li><a href="#DESCRIPTION">DESCRIPTION</a> <ul> <li><a href="#Encoding">Encoding</a></li> </ul> </li> <li><a href="#CLASS-METHODS">CLASS METHODS</a></li> <li><a href="#INSTANCE-METHODS">INSTANCE METHODS</a></li> <li><a href="#FUNCTIONS">FUNCTIONS</a></li> <li><a href="#DIAGNOSTICS">DIAGNOSTICS</a></li> <li><a href="#COMPATIBILITY">COMPATIBILITY</a></li> <li><a href="#CAVEATS">CAVEATS</a></li> <li><a href="#AUTHOR">AUTHOR</a></li> <li><a href="#COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</a></li> <li><a href="#SEE-ALSO">SEE ALSO</a></li> </ul></nav> <div class="pod anchors"> <h1 id="NAME">NAME</h1> <p>Pod::Text - Convert POD data to formatted text</p> <h1 id="SYNOPSIS">SYNOPSIS</h1> <pre><code>use Pod::Text; my $parser = Pod::Text->new (sentence => 1, width => 78); # Read POD from STDIN and write to STDOUT. $parser->parse_from_filehandle; # Read POD from file.pod and write to file.txt. $parser->parse_from_file ('file.pod', 'file.txt');</code></pre> <h1 id="DESCRIPTION">DESCRIPTION</h1> <p>Pod::Text is a module that can convert documentation in the POD format (the preferred language for documenting Perl) into formatted text. It uses no special formatting controls or codes, and its output is therefore suitable for nearly any device.</p> <h2 id="Encoding">Encoding</h2> <p>Pod::Text uses the following logic to choose an output encoding, in order:</p> <ol> <li><p>If a PerlIO encoding layer is set on the output file handle, do not do any output encoding and will instead rely on the PerlIO encoding layer.</p> </li> <li><p>If the <code>encoding</code> or <code>utf8</code> options are set, use the output encoding specified by those options.</p> </li> <li><p>If the input encoding of the POD source file was explicitly specified (using <code>=encoding</code>) or automatically detected by Pod::Simple, use that as the output encoding as well.</p> </li> <li><p>Otherwise, if running on a non-EBCDIC system, use UTF-8 as the output encoding. Since this is a superset of ASCII, this will result in ASCII output unless the POD input contains non-ASCII characters without declaring or autodetecting an encoding (usually via E<> escapes).</p> </li> <li><p>Otherwise, for EBCDIC systems, output without doing any encoding and hope this works.</p> </li> </ol> <p>One caveat: Pod::Text has to commit to an output encoding the first time it outputs a non-ASCII character, and then has to stick with it for consistency. However, <code>=encoding</code> commands don't have to be at the beginning of a POD document. If someone uses a non-ASCII character early in a document with an escape, such as E<0xEF>, and then puts <code>=encoding iso-8859-1</code> later, ideally Pod::Text would follow rule 3 and output the entire document as ISO 8859-1. Instead, it will commit to UTF-8 following rule 4 as soon as it sees that escape, and then stick with that encoding for the rest of the document.</p> <p>Unfortunately, there's no universally good choice for an output encoding. Each choice will be incorrect in some circumstances. This approach was chosen primarily for backwards compatibility. Callers should consider forcing the output encoding via <code>encoding</code> if they have any knowledge about what encoding the user may expect.</p> <p>In particular, consider importing the <a href="/pod/Encode::Locale">Encode::Locale</a> module, if available, and setting <code>encoding</code> to <code>locale</code> to use an output encoding appropriate to the user's locale. But be aware that if the user is not using locales or is using a locale of <code>C</code>, Encode::Locale will set the output encoding to US-ASCII. This will cause all non-ASCII characters will be replaced with <code>?</code> and produce a flurry of warnings about unsupported characters, which may or may not be what you want.</p> <h1 id="CLASS-METHODS"><a id="CLASS"></a>CLASS METHODS</h1> <dl> <dt id="new(ARGS)"><a id="new"></a><a id="new-ARGS"></a>new(ARGS)</dt> <dd> <p>Create a new Pod::Text object. ARGS should be a list of key/value pairs, where the keys are chosen from the following. Each option is annotated with the version of Pod::Text in which that option was added with its current meaning.</p> <dl> <dt id="alt">alt</dt> <dd> <p>[2.00] If set to a true value, selects an alternate output format that, among other things, uses a different heading style and marks <code>=item</code> entries with a colon in the left margin. Defaults to false.</p> </dd> <dt id="code">code</dt> <dd> <p>[2.13] If set to a true value, the non-POD parts of the input file will be included in the output. Useful for viewing code documented with POD blocks with the POD rendered and the code left intact.</p> </dd> <dt id="encoding">encoding</dt> <dd> <p>[5.00] Specifies the encoding of the output. The value must be an encoding recognized by the <a href="/pod/Encode">Encode</a> module (see <a href="/pod/Encode::Supported">Encode::Supported</a>). If the output contains characters that cannot be represented in this encoding, that is an error that will be reported as configured by the <code>errors</code> option. If error handling is other than <code>die</code>, the unrepresentable character will be replaced with the Encode substitution character (normally <code>?</code>).</p> <p>If the output file handle has a PerlIO encoding layer set, this parameter will be ignored and no encoding will be done by Pod::Man. It will instead rely on the encoding layer to make whatever output encoding transformations are desired.</p> <p>WARNING: The input encoding of the POD source is independent from the output encoding, and setting this option does not affect the interpretation of the POD input. Unless your POD source is US-ASCII, its encoding should be declared with the <code>=encoding</code> command in the source, as near to the top of the file as possible. If this is not done, Pod::Simple will will attempt to guess the encoding and may be successful if it's Latin-1 or UTF-8, but it will produce warnings. See <a href="http://man.he.net/man1/perlpod">perlpod(1)</a> for more information.</p> </dd> <dt id="errors">errors</dt> <dd> <p>[3.17] How to report errors. <code>die</code> says to throw an exception on any POD formatting error. <code>stderr</code> says to report errors on standard error, but not to throw an exception. <code>pod</code> says to include a POD ERRORS section in the resulting documentation summarizing the errors. <code>none</code> ignores POD errors entirely, as much as possible.</p> <p>The default is <code>pod</code>.</p> </dd> <dt id="guesswork">guesswork</dt> <dd> <p>[5.01] By default, Pod::Text applies some default formatting rules based on guesswork and regular expressions that are intended to make writing Perl documentation easier and require less explicit markup. These rules may not always be appropriate, particularly for documentation that isn't about Perl. This option allows turning all or some of it off.</p> <p>The special value <code>all</code> enables all guesswork. This is also the default for backward compatibility reasons. The special value <code>none</code> disables all guesswork. Otherwise, the value of this option should be a comma-separated list of one or more of the following keywords:</p> <dl> <dt id="quoting">quoting</dt> <dd> <p>If no guesswork is enabled, any text enclosed in C<> is surrounded by double quotes in nroff (terminal) output unless the contents are already quoted. When this guesswork is enabled, quote marks will also be suppressed for Perl variables, function names, function calls, numbers, and hex constants.</p> </dd> </dl> <p>Any unknown guesswork name is silently ignored (for potential future compatibility), so be careful about spelling.</p> </dd> <dt id="indent">indent</dt> <dd> <p>[2.00] The number of spaces to indent regular text, and the default indentation for <code>=over</code> blocks. Defaults to 4.</p> </dd> <dt id="loose">loose</dt> <dd> <p>[2.00] If set to a true value, a blank line is printed after a <code>=head1</code> heading. If set to false (the default), no blank line is printed after <code>=head1</code>, although one is still printed after <code>=head2</code>. This is the default because it's the expected formatting for manual pages; if you're formatting arbitrary text documents, setting this to true may result in more pleasing output.</p> </dd> <dt id="margin">margin</dt> <dd> <p>[2.21] The width of the left margin in spaces. Defaults to 0. This is the margin for all text, including headings, not the amount by which regular text is indented; for the latter, see the <i>indent</i> option. To set the right margin, see the <i>width</i> option.</p> </dd> <dt id="nourls">nourls</dt> <dd> <p>[3.17] Normally, L<> formatting codes with a URL but anchor text are formatted to show both the anchor text and the URL. In other words:</p> <pre><code>L<foo|http://example.com/></code></pre> <p>is formatted as:</p> <pre><code>foo <http://example.com/></code></pre> <p>This option, if set to a true value, suppresses the URL when anchor text is given, so this example would be formatted as just <code>foo</code>. This can produce less cluttered output in cases where the URLs are not particularly important.</p> </dd> <dt id="quotes">quotes</dt> <dd> <p>[4.00] Sets the quote marks used to surround C<> text. If the value is a single character, it is used as both the left and right quote. Otherwise, it is split in half, and the first half of the string is used as the left quote and the second is used as the right quote.</p> <p>This may also be set to the special value <code>none</code>, in which case no quote marks are added around C<> text.</p> </dd> <dt id="sentence">sentence</dt> <dd> <p>[3.00] If set to a true value, Pod::Text will assume that each sentence ends in two spaces, and will try to preserve that spacing. If set to false, all consecutive whitespace in non-verbatim paragraphs is compressed into a single space. Defaults to false.</p> </dd> <dt id="stderr">stderr</dt> <dd> <p>[3.10] Send error messages about invalid POD to standard error instead of appending a POD ERRORS section to the generated output. This is equivalent to setting <code>errors</code> to <code>stderr</code> if <code>errors</code> is not already set. It is supported for backward compatibility.</p> </dd> <dt id="utf8">utf8</dt> <dd> <p>[3.12] If this option is set to a true value, the output encoding is set to UTF-8. This is equivalent to setting <code>encoding</code> to <code>UTF-8</code> if <code>encoding</code> is not already set. It is supported for backward compatibility.</p> </dd> <dt id="width">width</dt> <dd> <p>[2.00] The column at which to wrap text on the right-hand side. Defaults to 76.</p> </dd> </dl> </dd> </dl> <h1 id="INSTANCE-METHODS"><a id="INSTANCE"></a>INSTANCE METHODS</h1> <p>As a derived class from Pod::Simple, Pod::Text supports the same methods and interfaces. See <a href="/pod/Pod::Simple">Pod::Simple</a> for all the details. This section summarizes the most-frequently-used methods and the ones added by Pod::Text.</p> <dl> <dt id="output_fh(FH)"><a id="output_fh"></a><a id="output_fh-FH"></a>output_fh(FH)</dt> <dd> <p>Direct the output from parse_file(), parse_lines(), or parse_string_document() to the file handle FH instead of <code>STDOUT</code>.</p> </dd> <dt id="output_string(REF)"><a id="output_string"></a><a id="output_string-REF"></a>output_string(REF)</dt> <dd> <p>Direct the output from parse_file(), parse_lines(), or parse_string_document() to the scalar variable pointed to by REF, rather than <code>STDOUT</code>. For example:</p> <pre><code>my $man = Pod::Man->new(); my $output; $man->output_string(\$output); $man->parse_file('/some/input/file');</code></pre> <p>Be aware that the output in that variable will already be encoded (see <a href="#Encoding">"Encoding"</a>).</p> </dd> <dt id="parse_file(PATH)"><a id="parse_file"></a><a id="parse_file-PATH"></a>parse_file(PATH)</dt> <dd> <p>Read the POD source from PATH and format it. By default, the output is sent to <code>STDOUT</code>, but this can be changed with the output_fh() or output_string() methods.</p> </dd> <dt id="parse_from_file(INPUT,-OUTPUT)"><a id="parse_from_file"></a><a id="parse_from_file-INPUT-OUTPUT"></a>parse_from_file(INPUT, OUTPUT)</dt> <dd> </dd> <dt id="parse_from_filehandle(FH,-OUTPUT)"><a id="parse_from_filehandle"></a><a id="parse_from_filehandle-FH-OUTPUT"></a>parse_from_filehandle(FH, OUTPUT)</dt> <dd> <p>Read the POD source from INPUT, format it, and output the results to OUTPUT.</p> <p>parse_from_filehandle() is provided for backward compatibility with older versions of Pod::Man. parse_from_file() should be used instead.</p> </dd> <dt id="parse_lines(LINES[,-...[,-undef]])"><a id="parse_lines"></a><a id="parse_lines-LINES-...-undef"></a>parse_lines(LINES[, ...[, undef]])</dt> <dd> <p>Parse the provided lines as POD source, writing the output to either <code>STDOUT</code> or the file handle set with the output_fh() or output_string() methods. This method can be called repeatedly to provide more input lines. An explicit <code>undef</code> should be passed to indicate the end of input.</p> <p>This method expects raw bytes, not decoded characters.</p> </dd> <dt id="parse_string_document(INPUT)"><a id="parse_string_document"></a><a id="parse_string_document-INPUT"></a>parse_string_document(INPUT)</dt> <dd> <p>Parse the provided scalar variable as POD source, writing the output to either <code>STDOUT</code> or the file handle set with the output_fh() or output_string() methods.</p> <p>This method expects raw bytes, not decoded characters.</p> </dd> </dl> <h1 id="FUNCTIONS">FUNCTIONS</h1> <p>Pod::Text exports one function for backward compatibility with older versions. This function is deprecated; instead, use the object-oriented interface described above.</p> <dl> <dt id="pod2text([[-a,]-[-NNN,]]-INPUT[,-OUTPUT])"><a id="pod2text"></a><a id="pod2text--a--NNN-INPUT-OUTPUT"></a>pod2text([[-a,] [-NNN,]] INPUT[, OUTPUT])</dt> <dd> <p>Convert the POD source from INPUT to text and write it to OUTPUT. If OUTPUT is not given, defaults to <code>STDOUT</code>. INPUT can be any expression supported as the second argument to two-argument open().</p> <p>If <code>-a</code> is given as an initial argument, pass the <code>alt</code> option to the Pod::Text constructor. This enables alternative formatting.</p> <p>If <code>-NNN</code> is given as an initial argument, pass the <code>width</code> option to the Pod::Text constructor with the number <code>NNN</code> as its argument. This sets the wrap line width to NNN.</p> </dd> </dl> <h1 id="DIAGNOSTICS">DIAGNOSTICS</h1> <dl> <dt id="Bizarre-space-in-item"><a id="Bizarre"></a>Bizarre space in item</dt> <dd> </dd> <dt id="Item-called-without-tag"><a id="Item"></a>Item called without tag</dt> <dd> <p>(W) Something has gone wrong in internal <code>=item</code> processing. These messages indicate a bug in Pod::Text; you should never see them.</p> </dd> <dt id="Can't-open-%s-for-reading:-%s"><a id="Can"></a><a id="Cant-open-s-for-reading:-s"></a>Can't open %s for reading: %s</dt> <dd> <p>(F) Pod::Text was invoked via the compatibility mode pod2text() interface and the input file it was given could not be opened.</p> </dd> <dt id="Invalid-errors-setting-"%s""><a id="Invalid"></a><a id="Invalid-errors-setting-s"></a>Invalid errors setting "%s"</dt> <dd> <p>(F) The <code>errors</code> parameter to the constructor was set to an unknown value.</p> </dd> <dt id="Invalid-quote-specification-"%s""><a id="Invalid1"></a><a id="Invalid-quote-specification-s"></a>Invalid quote specification "%s"</dt> <dd> <p>(F) The quote specification given (the <code>quotes</code> option to the constructor) was invalid. A quote specification must be either one character long or an even number (greater than one) characters long.</p> </dd> <dt id="POD-document-had-syntax-errors"><a id="POD"></a>POD document had syntax errors</dt> <dd> <p>(F) The POD document being formatted had syntax errors and the <code>errors</code> option was set to <code>die</code>.</p> </dd> </dl> <h1 id="COMPATIBILITY">COMPATIBILITY</h1> <p>Pod::Text 2.03 (based on <a href="/pod/Pod::Parser">Pod::Parser</a>) was the first version of this module included with Perl, in Perl 5.6.0. Earlier versions of Perl had a different Pod::Text module, with a different API.</p> <p>The current API based on <a href="/pod/Pod::Simple">Pod::Simple</a> was added in Pod::Text 3.00. Pod::Text 3.01 was included in Perl 5.9.3, the first version of Perl to incorporate those changes. This is the first version that correctly supports all modern POD syntax. The parse_from_filehandle() method was re-added for backward compatibility in Pod::Text 3.07, included in Perl 5.9.4.</p> <p>Pod::Text 3.12, included in Perl 5.10.1, first implemented the current practice of attempting to match the default output encoding with the input encoding of the POD source, unless overridden by the <code>utf8</code> option or (added later) the <code>encoding</code> option.</p> <p>Support for anchor text in L<> links of type URL was added in Pod::Text 3.14, included in Perl 5.11.5.</p> <p>parse_lines(), parse_string_document(), and parse_file() set a default output file handle of <code>STDOUT</code> if one was not already set as of Pod::Text 3.18, included in Perl 5.19.5.</p> <p>Pod::Text 4.00, included in Perl 5.23.7, aligned the module version and the version of the podlators distribution. All modules included in podlators, and the podlators distribution itself, share the same version number from this point forward.</p> <p>Pod::Text 4.09, included in Perl 5.25.7, fixed a serious bug on EBCDIC systems, present in all versions back to 3.00, that would cause opening brackets to disappear.</p> <p>Pod::Text 5.00 and later, included in Perl 5.37.7, default, on non-EBCDIC systems, to UTF-8 encoding if it sees a non-ASCII character in the input and the input encoding is not specified. They also commit to an encoding with the first non-ASCII character and does not change the output encoding if the input encoding changes. The <a href="/pod/Encode">Encode</a> module is now used for all output encoding rather than PerlIO layers, which fixes earlier problems with output to scalars.</p> <h1 id="CAVEATS">CAVEATS</h1> <p>Line wrapping is done only at ASCII spaces and tabs, rather than using a correct Unicode-aware line wrapping algorithm.</p> <h1 id="AUTHOR">AUTHOR</h1> <p>Russ Allbery <rra@cpan.org>, based <i>very</i> heavily on the original Pod::Text by Tom Christiansen <tchrist@mox.perl.com> and its conversion to Pod::Parser by Brad Appleton <bradapp@enteract.com>. Sean Burke's initial conversion of Pod::Man to use Pod::Simple provided much-needed guidance on how to use Pod::Simple.</p> <h1 id="COPYRIGHT-AND-LICENSE"><a id="COPYRIGHT"></a>COPYRIGHT AND LICENSE</h1> <p>Copyright 1999-2002, 2004, 2006, 2008-2009, 2012-2016, 2018-2019, 2022 Russ Allbery <rra@cpan.org></p> <p>This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.</p> <h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1> <p><a href="/pod/Encode::Locale">Encode::Locale</a>, <a href="/pod/Encode::Supproted">Encode::Supproted</a>, <a href="/pod/Pod::Simple">Pod::Simple</a>, <a href="/pod/Pod::Text::Termcap">Pod::Text::Termcap</a>, <a href="http://man.he.net/man1/perlpod">perlpod(1)</a>, <a href="http://man.he.net/man1/pod2text">pod2text(1)</a></p> <p>The current version of this module is always available from its web site at <a href="https://www.eyrie.org/~eagle/software/podlators/">https://www.eyrie.org/~eagle/software/podlators/</a>. It is also part of the Perl core distribution as of 5.6.0.</p></div> <div id="metacpan_install-instructions-dialog" class="modal fade"> <div class="modal-dialog"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button> <h4 class="modal-title">Module Install Instructions</h4> </div> <div class="modal-body"> <p>To install Pod::Man, copy and paste the appropriate command in to your terminal.</p> <p><a href="/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p> <pre><code>cpanm Pod::Man</code></pre> <p><a href="/pod/CPAN">CPAN shell</a></p> <pre><code>perl -MCPAN -e shell install Pod::Man</code></pre> <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p> </div> <div class="modal-footer"> <a href="#" data-dismiss="modal" class="btn">Close</a> </div> </div> </div> </div> </main> <div class="content-pagination"> </div> </div> <footer class="footer"> <div class="footer-container"> <div class="footer-social"> <div class="footer-link footer-logo"> <a href="/"> <img src="/static/images/metacpan-logo.svg" alt="MetaCPAN" /> </a> </div> <a class="footer-social-link" href="https://github.com/metacpan"> <i class="fab fa-github-square"></i> </a> <a class="footer-social-link" href="https://fosstodon.org/@metacpan"> <i class="fab fa-mastodon"></i> </a> </div> <div class="footer-links"> <div class="footer-link"> <a href="/about">About</a> </div> <div class="footer-link"> <a href="/about/sponsors">Sponsor</a> </div> <div class="footer-link"> <a href="https://grep.metacpan.org">grep::cpan</a> </div> <div class="footer-link"> <a href="/recent">Recent</a> </div> <div class="footer-link"> <a href="/about/faq">FAQ</a> </div> <div class="footer-link"> <a href="/tools">Tools</a> </div> <div class="footer-link"> <a href="https://fastapi.metacpan.org/">API</a> </div> <div class="footer-link"> <a href="https://www.perl.org/">Perl.org</a> </div> </div> <div class="footer-sponsors"> <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener"> <img class="footer-sponsor-bytemark" src="/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener"> <img class="footer-sponsor-liquidweb" src="/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener"> <img class="footer-sponsor-deriv" src="/static/images/sponsors/deriv.svg" alt="Deriv logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener"> <img class="footer-sponsor-geocode" src="/static/images/sponsors/geocodelogo.svg" alt="Geocode logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener"> <img class="footer-sponsor-fastly" src="/static/images/sponsors/fastly_logo.svg" alt="Fastly logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener"> <img class="footer-sponsor-opencage" src="/static/images/sponsors/open-cage.svg" alt="OpenCage logo"> </a>  <a class="footer-sponsor-link" target="_blank" href="https://www.elastic.co/" rel="noopener"> <img class="footer-sponsor-elastic" src="/static/images/sponsors/elastic.svg" alt="Elastic logo"> </a>  <a class="footer-sponsor-link" target="_blank" href="https://route4me.com/" rel="noopener"> <img class="footer-sponsor-route4me" src="/static/images/sponsors/route4me.png" alt="Route4Me logo"> </a> </div> </div> </footer> <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts"> <div class="modal-dialog"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal">×</button> <h4 class="modal-title">Keyboard Shortcuts</h4> </div> <div class="modal-body row"> <div class="col-md-6"> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>Global</th> </tr> </thead> <tbody> <tr> <td class="keys"> <kbd>s</kbd> </td> <td>Focus search bar</td> </tr> <tr> <td class="keys"> <kbd>?</kbd> </td> <td>Bring up this help dialog</td> </tr> </tbody> </table> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>GitHub</th> </tr> </thead> <tbody> <tr> <td class="keys"> <kbd>g</kbd> <kbd>p</kbd> </td> <td>Go to pull requests</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>i</kbd> </td> <td>go to github issues (only if github is preferred repository)</td> </tr> </tbody> </table> </div> <div class="col-md-6"> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>POD</th> </tr> </thead> <tbody> <tr> <td class="keys"> <kbd>g</kbd> <kbd>a</kbd> </td> <td>Go to author</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>c</kbd> </td> <td>Go to changes</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>i</kbd> </td> <td>Go to issues</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>d</kbd> </td> <td>Go to dist</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>r</kbd> </td> <td>Go to repository/SCM</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>s</kbd> </td> <td>Go to source</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>b</kbd> </td> <td>Go to file browse</td> </tr> </tbody> </table> </div> <div class="col-md-12"> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>Search terms</th> </tr> </thead> <tbody> <tr> <td><em>module:</em> (e.g. <a href="/search?q=module%3APlugin">module:Plugin</a>)</td> </tr> <tr> <td><em>distribution:</em> (e.g. <a href="/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td> </tr> <tr> <td><em>author:</em> (e.g. <a href="/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td> </tr> <tr> <td><em>version:</em> (e.g. <a href="/search?q=version%3A1.00">version:1.00</a>)</td> </tr> </tbody> </table> </div> </div> <div class="modal-footer"></div> </div> </div> </div> </body> </html>

CINXE.COM

Pod::Text - Convert POD data to formatted text - metacpan.org