Help language development. Donate to The Perl Foundation

Pod::Load zef:jjmerelo last updated on 2022-02-12

84e13919fdc914b9ae9594eb8aa54baceb4d9679/

Build
status Test in a Raku container

NAME

Pod::Load - Loads and compiles the Pod documentation of an external file

SYNOPSIS

use Pod::Load;

# Read a file handle.
my $pod = load("file-with.pod6".IO);
say $pod.raku; # Process it as a Pod

# Or use simply the file name
my @pod = load("file-with.pod6");
say .raku for @pod;

# Or a string
@pod = load("=begin pod\nThis could be a comment with C<code>\n=end pod");

# Or ditch the scaffolding and use the string directly:
@pod = load-pod("This could be a comment with C<code>");

DESCRIPTION

Pod::Load is a module with a simple task: obtain the documentation of an external file in a standard, straighworward way. Its mechanism is inspired by Pod::To::BigPage, from where the code to use the cache is taken from.

multi sub load

multi sub load(
    Str $string
) returns Mu

Loads a string, returns a Pod.

multi sub load

multi sub load(
    Str $file where { ... }
) returns Mu

If it's an actual filename, loads a file and returns the pod

multi sub load

multi sub load(
    IO::Path $io
) returns Mu

Loads a IO::Path, returns a Pod.

INSTALL

Do the usual:

zef install .

to install this if you've made any modification.

INSTRUCTIONS

This is mainly a reminder to myself, although it can help you if you create a distribution just like this one.

Write:

export VERSION=0.x.x

And

make dist

To create a tar file ready for CPAN.

AUTHOR

JJ Merelo [email protected]

COPYRIGHT AND LICENSE

Copyright 2018, 2019, 2020 JJ Merelo

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.