App::PodLinkCheck::ParseSections -- parse out section names from POD
use App::PodLinkCheck::ParseSections;
Pod::Simple App::PodLinkCheck::ParseSections
This is a POD parser used by App::PodLinkCheck to find section names in a document. Its behaviour is specific to PodLinkCheck but might have other use.
App::PodLinkCheck
$parser = App::PodLinkCheck::ParseSections->new($options_hashref)
Create and return a new parser object.
The default is to disable Pod::Simple whining about dubious pod, because App::PodLinkCheck is just meant to check links. $options_hashref can have verbose to give full messages from Pod::Simple.
Pod::Simple
$options_hashref
verbose
$parser = App::PodLinkCheck::ParseSections->new({ verbose => 1 });
It also works to set $parser->no_whining() as desired at any time.
$parser->no_whining()
$parser->parse_file($filename)
Parse the pod from $filename. All the various Pod::Simple parse input styles can be used too.
$filename
$hashref = $parser->sections_hashref()
Return a hashref of the names of POD sections seen by $parser. The keys are the section names. The values are true (presently just 1).
$parser
Sections names are mildly normalized by collapsing whitespace to a single space each and removing leading and trailing whitespace. Believe that's mostly how the pod formatters end up treating section names for linking purposes. (That sort of treatment being the intention here.)
The first word (of non-whitespace) of a section name is added as a hash entry too. This is in the style of Pod::Checker and is how the formatters help links to function names in for example perlfunc.
Pod::Checker
The section names accumulate everything seen by $parser. No attention is paid to any "Document" start etc. Usually a new App::PodLinkCheck::ParseSections is used for each file (unless some union of section names is in fact wanted).
App::PodLinkCheck::ParseSections
App::PodLinkCheck, App::PodLinkCheck::ParseLinks
http://user42.tuxfamily.org/podlinkcheck/index.html
Copyright 2010, 2011, 2012, 2013, 2016 Kevin Ryde
PodLinkCheck is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.
PodLinkCheck is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with PodLinkCheck. If not, see <http://www.gnu.org/licenses/>.
To install podlinkcheck, copy and paste the appropriate command in to your terminal.
cpanm
cpanm podlinkcheck
CPAN shell
perl -MCPAN -e shell install podlinkcheck
For more information on module installation, please visit the detailed CPAN module installation guide.