Documentation fixes

lib/XML/LibXML/Cache.pm

@@ -47,7 +47,7 @@ __END__
 
 =head1 DESCRIPTION
 
-XML::LibXML::Cache is a cache for XML::LibXML documents loaded from
+XML::LibXML::Cache is a cache for L<XML::LibXML> documents loaded from
 files. It is useful to speed up loading of XML files in persistent web
 applications.
 
@@ -61,7 +61,7 @@ cause a reload. This includes external DTDs, external entities or XIncludes.
     my $cache = XML::LibXML::Cache->new;
 
     my $doc = $cache->parse_file('file.xml');
-    my $doc = $cache->parse_html_file('file.html', %opts);
+    my $doc = $cache->parse_html_file('file.html', \%opts);
 
 =head1 METHODS
 
@@ -76,7 +76,7 @@ Creates a new cache. Valid options are:
 
 =item parser
 
-The XML::LibXML parser object that should be used to load documents if you
+The L<XML::LibXML> parser object that should be used to load documents if you
 want to use certain parser options. If this options is missing a parser
 with default options will be used.
 
@@ -86,12 +86,12 @@ with default options will be used.
 
     my $doc = $cache->parse_file($filename);
 
-Works like parse_file in XML::LibXML.
+Works like L<XML::LibXML::Parser/parse_file>.
 
 =head2 parse_html_file
 
     my $doc = $cache->parse_html_file($filename, \%opts);
 
-Works like parse_html_file in XML::LibXML.
+Works like L<XML::LibXML::Parser/parse_html_file>.
 
 =cut

lib/XML/LibXSLT/Cache.pm

@@ -1,7 +1,7 @@
 package XML::LibXSLT::Cache;
 use strict;
 
-# ABSTRACT: Stylesheet cache for XML::LibXSLT
+# ABSTRACT: Style sheet cache for XML::LibXSLT
 
 use base qw(XML::LibXML::Cache::Base);
 
@@ -41,14 +41,14 @@ __END__
 
 =head1 DESCRIPTION
 
-XML::LibXSLT::Cache is a cache for XML::LibXSLT stylesheets loaded from
-files. It is useful to speed up loading of XSLT stylesheets in persistent web
+XML::LibXSLT::Cache is a cache for L<XML::LibXSLT> style sheets loaded from
+files. It is useful to speed up loading of XSLT style sheets in persistent web
 applications.
 
-This module caches the stylesheet object after the first load and returns the
-cached version on subsequent loads. Stylesheets are reloaded whenever the
-stylesheet file changes. Changes to other files referenced during parsing also
-cause a reload, for example via xsl:import and xsl:include.
+This module caches the style sheet object after the first load and returns the
+cached version on subsequent loads. Style sheets are reloaded whenever the
+style sheet file changes. Changes to other files referenced during parsing also
+cause a reload, for example when using xsl:import and xsl:include.
 
 =head1 SYNOPSIS
 
@@ -69,17 +69,17 @@ Creates a new cache. Valid options are:
 
 =item xslt
 
-The XML::LibXSLT object that should be used to load stylsheets if you
+The L<XML::LibXSLT> object that should be used to load stylsheets if you
 want to reuse an existing object. If this options is missing a new
 XML::LibXSLT object will be created.
 
 =back
 
 =head2 parse_stylesheet_file
 
-    my $doc = $cache->parse_stylesheet_file($filename);
+    my $stylesheet = $cache->parse_stylesheet_file($filename);
 
-Works like parse_stylesheet_file in XML::LibXSLT.
+Works like L<XML::LibXSLT/parse_stylesheet_file>.
 
 =cut