Commits

Toby Inkster committed 3d1cbc9

minor updates (mostly doc fixes)

Comments (0)

Files changed (6)

TODO

-TODO:
-- https://rt.cpan.org/Ticket/Display.html?id=66278

lib/XML/Saxon/XSLT2.pm

 package XML::Saxon::XSLT2;
 
 use 5.008;
-use common::sense;
+use strict;
 
 use Carp;
 use IO::Handle;
 use Scalar::Util qw[blessed];
 use XML::LibXML;
 
-our $VERSION = '0.006';
+our $VERSION = '0.007';
 my $classpath;
 
 BEGIN
 just dowload the latest Java release of Saxon-HE 9.x, open the Zip archive,
 extract saxon9he.jar and save it to one of the two directories above.
 
-=head2 Use Line
+=head2 Import
 
  use XML::Saxon::XSLT2;
 
 
  use XML::Saxon::XSLT2 EXTRA_JAVA_ARGS => '-Xmx256m';
 
+The C<import> function I<must> be called. If you load this module without
+importing it, it will not work. (Don't worry, it won't pollute your namespace.)
+
 =head2 Constructor
 
 =over 4
 Creates a new transformation. $xslt may be a string, a file handle or an
 L<XML::LibXML::Document>. $baseurl is an optional base URL for resolving
 relative URL references in, for instance, E<lt>xsl:importE<gt> links.
-Otherwise, the current directory is assumed to be the base.
+Otherwise, the current directory is assumed to be the base. (For base URIs
+which are filesystem directories, remember to include the trailing slash.)
 
 =back
 
 value. For example:
 
  $trans->parameters(
-    now           => DateTime->now,
+    now             => DateTime->now,
     madrid_is_capital_of_spain => [ boolean => 1 ],
-    price_of_fish => [ decimal => '1.99' ],
-    my_link       => URI->new('http://example.com/'),
-    your_link     => [ uri => 'http://example.net/' ],
-    );
+    price_of_fish   => [ decimal => '1.99' ],
+    my_link         => URI->new('http://example.com/'),
+    your_link       => [ uri => 'http://example.net/' ],
+ );
 
 The following types are supported via the arrayref notation: float, double,
 long (alias int, integer), decimal, bool (alias boolean), string, qname, uri,
 $output_method may be 'xml', 'xhtml', 'html' or 'text' to override
 the XSLT output method; or 'default' to use the output method specified
 in the XSLT file. 'default' is the default. In the current release,
-'default' is also broken. :-(
+'default' is broken. :-(
 
 =item C<< $trans->transform_document($doc, [$output_method]) >>
 
 
 =head1 SEE ALSO
 
-L<XML::LibXSLT> is probably more reliable, and allows you to define your
-own XSLT extension functions. However, the libxslt library that it's based
-on only supports XSLT 1.0.
+L<XML::LibXSLT> is probably more reliable in terms of easy installation on a
+variety of platforms, and it allows you to define your own XSLT extension
+functions. However, the libxslt library that it's based on only supports XSLT
+1.0.
 
-L<Inline::Java>.
+This module uses L<Inline::Java>.
 
 L<http://saxon.sourceforge.net/>.
 
 
 =head1 COPYRIGHT
 
-Copyright 2010-2011 Toby Inkster
+Copyright 2010-2012 Toby Inkster
 
 This library is free software; you can redistribute it and/or modify it
 under the same terms as Perl itself.
 		dcs:item   [ a dcs:Packaging ; rdfs:label "Upgrade Module::Package::RDF version."@en ] ;
 		dcs:item   [ a dcs:Documentation ; rdfs:label "Mention that the 'default' value for the output format of the 'transform' method is broken."@en ] 
 	] .
+
+my:project :release my:v_0-007 .
+my:v_0-007
+	a               :Version ;
+	dc:issued       "2012-09-11"^^xsd:date ;
+	:revision       "0.007"^^xsd:string ;
+	rdfs:label      "Shaken, not stirred"@en;
+	:file-release   <http://backpan.cpan.org/authors/id/T/TO/TOBYINK/Module-Install-RDF-0.007.tar.gz> ;
+	dcs:changeset [
+		dcs:versus my:v_0-006 ;
+		dcs:item   [ a dcs:Packaging ; rdfs:label "Drop common::sense dependency."@en ] ;
+		dcs:item   [ a dcs:Documentation ; rdfs:label "Improve documentation of base URIs."@en; dcs:fixes <http://purl.org/NET/cpan-uri/rt/ticket/79463> ] ;
+		dcs:item   [ a dcs:Documentation ; rdfs:label "Improve documentation of import function."@en ] ;
+	] .
 	:homepage       <https://metacpan.org/release/XML-Saxon-XSLT2> ;
 	:download-page  <https://metacpan.org/release/XML-Saxon-XSLT2> ;
 	:bug-database   <http://rt.cpan.org/Dist/Display.html?Queue=XML-Saxon-XSLT2> ;
-	:repository     [ a :SVNRepository ; :browse <http://goddamn.co.uk/svn-web/perlmods/browse/XML-Saxon-XSLT2/> ] ;
+	:repository     [ a :HgRepository ; :browse <https://bitbucket.org/tobyink/p5-xml-saxon-xslt2> ] ;
 	:maintainer     toby:i ;
 	:developer      toby:i ;
 	:documenter     toby:i ;

meta/makefile.ttl

 	:perl_version_from _:main ;
 	:version_from _:main ;
 	:readme_from _:main ;
-	:requires "common::sense" , "Carp 1.00" , "Inline::Java" , "IO::Handle" , "Scalar::Util" , "XML::LibXML 1.60" ;
+	:requires "Inline::Java", "XML::LibXML 1.60" ;
 	:test_requires "Test::More 0.61" .
 
 _:main <http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#fileName> "lib/XML/Saxon/XSLT2.pm" .
+@prefix dbug: <http://ontologi.es/doap-bugs#> .
+@prefix dc: <http://purl.org/dc/terms/> .
+@prefix doap: <http://usefulinc.com/ns/doap#> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix prio: <http://purl.org/NET/cpan-uri/rt/priority/> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix rt: <http://purl.org/NET/cpan-uri/rt/ticket/> .
+@prefix status: <http://purl.org/NET/cpan-uri/rt/status/> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+_:r1347364015r0 a foaf:Agent ;
+	foaf:mbox <mailto:mauricemengel@gmail.com> .
+_:r1347364015r1 a foaf:Agent ;
+	foaf:nick "TOBYINK" .
+_:r1347364015r2 a foaf:Agent ;
+	foaf:nick "Nobody" .
+_:r1347364015r3 a foaf:Agent ;
+	foaf:mbox <mailto:quentin@mit.edu> .
+_:r1347364015r4 a foaf:Agent ;
+	foaf:mbox <mailto:mail@tobyinkster.co.uk> .
+<http://purl.org/NET/cpan-uri/dist/XML-Saxon-XSLT2/project> dbug:issue <http://purl.org/NET/cpan-uri/rt/ticket/60584>, <http://purl.org/NET/cpan-uri/rt/ticket/60589>, <http://purl.org/NET/cpan-uri/rt/ticket/60645>, <http://purl.org/NET/cpan-uri/rt/ticket/60646>, <http://purl.org/NET/cpan-uri/rt/ticket/60648>, <http://purl.org/NET/cpan-uri/rt/ticket/66276>, <http://purl.org/NET/cpan-uri/rt/ticket/66278>, <http://purl.org/NET/cpan-uri/rt/ticket/79463> .
+<http://purl.org/NET/cpan-uri/rt/ticket/60584> dbug:assignee _:r1347364015r1 ;
+	dbug:id "60584"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=60584> ;
+	dbug:reporter _:r1347364015r0 ;
+	dbug:status status:resolved ;
+	dc:created "2010-08-21T05:04:04"^^xsd:dateTime ;
+	dc:modified "2010-08-23T17:33:00"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "mismatch Manifest" .
+<http://purl.org/NET/cpan-uri/rt/ticket/60589> dbug:assignee _:r1347364015r1 ;
+	dbug:id "60589"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=60589> ;
+	dbug:reporter _:r1347364015r0 ;
+	dbug:status status:resolved ;
+	dc:created "2010-08-21T14:24:06"^^xsd:dateTime ;
+	dc:modified "2011-02-18T23:20:58"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "usage more explicit?" .
+<http://purl.org/NET/cpan-uri/rt/ticket/60645> dbug:assignee _:r1347364015r2 ;
+	dbug:id "60645"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=60645> ;
+	dbug:reporter _:r1347364015r0 ;
+	dbug:status status:rejected ;
+	dc:created "2010-08-23T17:32:51"^^xsd:dateTime ;
+	dc:modified "2011-02-18T22:47:26"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "" .
+<http://purl.org/NET/cpan-uri/rt/ticket/60646> dbug:assignee _:r1347364015r1 ;
+	dbug:id "60646"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=60646> ;
+	dbug:reporter _:r1347364015r0 ;
+	dbug:status status:resolved ;
+	dc:created "2010-08-23T17:37:21"^^xsd:dateTime ;
+	dc:modified "2011-02-18T23:19:31"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "variable memory requirements" .
+<http://purl.org/NET/cpan-uri/rt/ticket/60648> dbug:assignee _:r1347364015r2 ;
+	dbug:id "60648"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=60648> ;
+	dbug:reporter _:r1347364015r0 ;
+	dbug:status status:rejected ;
+	dc:created "2010-08-23T17:51:32"^^xsd:dateTime ;
+	dc:modified "2011-02-18T23:13:18"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "measuring performance" .
+<http://purl.org/NET/cpan-uri/rt/ticket/66276> dbug:assignee _:r1347364015r1 ;
+	dbug:id "66276"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=66276> ;
+	dbug:reporter _:r1347364015r3 ;
+	dbug:status status:resolved ;
+	dc:created "2011-03-01T09:32:22"^^xsd:dateTime ;
+	dc:modified "2011-10-03T22:33:21"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "Classpath is searched in wrong order" .
+<http://purl.org/NET/cpan-uri/rt/ticket/66278> dbug:assignee _:r1347364015r1 ;
+	dbug:id "66278"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=66278> ;
+	dbug:reporter _:r1347364015r3 ;
+	dbug:status status:open ;
+	dc:created "2011-03-01T10:46:58"^^xsd:dateTime ;
+	dc:modified "2011-10-03T21:47:56"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "xsl:result-document element doesn't work" .
+<http://purl.org/NET/cpan-uri/rt/ticket/79463> dbug:assignee _:r1347364015r1 ;
+	dbug:id "79463"^^xsd:string ;
+	dbug:page <https://rt.cpan.org/Ticket/Display.html?id=79463> ;
+	dbug:reporter _:r1347364015r4 ;
+	dbug:status status:resolved ;
+	dc:created "2012-09-05T22:35:39"^^xsd:dateTime ;
+	dc:modified "2012-09-11T12:44:53"^^xsd:dateTime ;
+	a dbug:Issue ;
+	rdfs:label "Insufficient documentation - baseuri" .