/usr/share/perl5/YAML/Any.pod is in libyaml-perl 1.24-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 | =pod
=for comment
DO NOT EDIT. This Pod was generated by Swim v0.1.46.
See http://github.com/ingydotnet/swim-pm#readme
=encoding utf8
=head1 NAME
YAML::Any - Pick a YAML implementation and use it.
=head1 STATUS
WARNING: This module will soon be deprecated. The plan is that YAML.pm itself
will act like an I<Any> module.
=head1 SYNOPSIS
use YAML::Any;
$YAML::Indent = 3;
my $yaml = Dump(@objects);
=head1 DESCRIPTION
There are several YAML implementations that support the Dump/Load API. This
module selects the best one available and uses it.
=head1 ORDER
Currently, YAML::Any will choose the first one of these YAML implementations
that is installed on your system:
=over
=item * YAML::XS
=item * YAML::Syck
=item * YAML::Old
=item * YAML
=item * YAML::Tiny
=back
=head1 OPTIONS
If you specify an option like:
$YAML::Indent = 4;
And YAML::Any is using YAML::XS, it will use the proper variable:
$YAML::XS::Indent.
=head1 SUBROUTINES
Like all the YAML modules that YAML::Any uses, the following subroutines are
exported by default:
=over
=item * Dump
=item * Load
=back
and the following subroutines are exportable by request:
=over
=item * DumpFile
=item * LoadFile
=back
=head1 METHODS
YAML::Any provides the following class methods.
=over
=item C<< YAML::Any->order >>
This method returns a list of the current possible implementations that
YAML::Any will search for.
=item C<< YAML::Any->implementation >>
This method returns the implementation the YAML::Any will use. This result is
obtained by finding the first member of YAML::Any->order that is either
already loaded in C<%INC> or that can be loaded using C<require>. If no
implementation is found, an error will be thrown.
=back
=head1 EXAMPLES
=head2 DumpFile and LoadFile
Here is an example for C<DumpFile>:
#!/usr/bin/perl
use strict;
use warnings;
use YAML::Any qw(DumpFile);
my $ds =
{
array => [5,6,100],
string => "Hello",
};
DumpFile("hello.yml", $ds);
When run, this creates a file called C<hello.yml> in the current working
directory, with the following contents.
---
array:
- 5
- 6
- 100
string: Hello
In turn, the following C<LoadFile> example, loads the contents from there and
accesses them:
#!/usr/bin/perl
use strict;
use warnings;
use YAML::Any qw(LoadFile);
my ($ds) = LoadFile("hello.yml");
print "String == '", $ds->{string}, "'\n";
Assuming C<hello.yml> exists, and is as created by the C<DumpFile> example,
it prints:
$ perl load.pl
String == 'Hello'
$
=head1 AUTHOR
Ingy döt Net <ingy@cpan.org>
=head1 COPYRIGHT
Copyright 2001-2014. Ingy döt Net
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
See L<http://www.perl.com/perl/misc/Artistic.html>
=cut
|