added a caveat regarding XML::Simple's strict mode (Peter Corlett)
[p5sagit/Config-Any.git] / lib / Config / Any / XML.pm
index 9c49443..ca2d55b 100644 (file)
@@ -73,6 +73,28 @@ sub _coerce {
     $out;
 }
 
+=head2 is_supported( )
+
+Returns true if L<XML::Simple> is available.
+
+=cut
+
+sub is_supported {
+    eval { require XML::Simple; };
+    return $@ ? 0 : 1;
+}
+
+=head1 CAVEATS
+
+=head2 Strict Mode
+
+If, by some chance, L<XML::Simple> has already been loaded with the strict
+flag turned on, then you will likely get errors as warnings will become
+fatal exceptions and certain arguments to XMLin() will no longer be optional.
+
+See L<XML::Simple's strict mode documentation|XML::Simple/STRICT_MODE> for
+more information.
+
 =head1 AUTHORS
 
 Brian Cassidy E<lt>bricas@cpan.orgE<gt>