-
-
17 Dec 2019 00:12:50 UTC
- Distribution: String-PodQuote
- Module version: 0.003
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (2316 / 0 / 2)
- Kwalitee
Bus factor: 1- 100.00% Coverage
- License: perl_5
- Perl: v5.10.1
- Activity
24 month- Tools
- Download (14.3KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- NAME
- VERSION
- SYNOPSIS
- DESCRIPTION
- FUNCTIONS
- HOMEPAGE
- SOURCE
- BUGS
- SEE ALSO
- AUTHOR
- COPYRIGHT AND LICENSE
NAME
String::PodQuote - Escape/quote special characters that might be interpreted by a POD parser
VERSION
This document describes version 0.003 of String::PodQuote (from Perl distribution String-PodQuote), released on 2019-12-17.
SYNOPSIS
use String::PodQuote qw(pod_escape);
Putting a text as-is in an ordinary paragraph:
print "=pod\n\n", pod_escape("First paragraph containing C<=>.\n\n Second indented paragraph.\n\n"), "=cut\n\n";
will output:
=pod First paragraph containing CE<lt>=E<gt>. E<32> Second indented paragraph.
Putting text inside a POD link:
print "L<", pod_escape("Some description containing <, >, |, /"), "|Some::Module>";
will output:
L<Some description containing <, E<gt>, E<verbar>, E<sol>|Some::Module>
DESCRIPTION
FUNCTIONS
pod_escape
Usage:
$escaped = pod_escape($text);
Quote special characters that might be interpreted by a POD parser.
The following characters are escaped:
Character Escaped into --------- ------------ < (only when preceded by a capital letter) E<lt> > E<gt> | E<verbar> / E<sol> (Space) (only at beginning of string/line) E<32> (Tab) (only at beginning of string/line) E<9> = (only at beginning of string/line) E<61>
pod_quote
Alias for pod_escape.
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/String-PodQuote.
SOURCE
Source repository is at https://github.com/perlancar/perl-String-PodQuote.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=String-PodQuote
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
SEE ALSO
Tangentially related modules: HTML::Entities, URI::Escape, String::ShellQuote, String::Escape, String::PerlQuote.
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2019 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install String::PodQuote, copy and paste the appropriate command in to your terminal.
cpanm String::PodQuote
perl -MCPAN -e shell install String::PodQuote
For more information on module installation, please visit the detailed CPAN module installation guide.