Scroll to navigation

Pod::Weaver::Role::StringFromComment(3pm) User Contributed Perl Documentation Pod::Weaver::Role::StringFromComment(3pm)
 

NAME

Pod::Weaver::Role::StringFromComment - Extract a string from a specially formatted comment

VERSION

version 4.006

OVERVIEW

This role assists Pod::Weaver sections by allowing them to pull strings from the source comments formatted like: 
    # KEYNAME: Some string...
This is probably the most familiar to people using lines like the following to allow the Name section to determine a module's abstract: 
    # ABSTRACT: Provides the HypnoToad with mind-control powers
It will extract these strings by inspecting the "ppi_document" which must be given.

PRIVATE METHODS

This role supplies only methods meant to be used internally by its consumer.

_extract_comment_content($ppi_doc, $key)

Given a key, try to find a comment matching "# $key:" in the $ppi_document and return everything but the prefix.
e.g., given a document with a comment in it of the form: 
    # ABSTRACT: Yada yada...
...and this is called... 
    $self->_extract_comment_content($ppi, 'ABSTRACT')
...it returns to us: 
    Yada yada...

AUTHOR

Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
2014-01-08 perl v5.18.1