Saxon

As noted in bug 3157:

A number of JAXPExamples tests use the "Books List sample", and this has a couple of issues. The DTD reference is missing from data/books.xml, which is required for the associated stylesheet styles/books.xsl to work correctly (it uses the fn:id() function). Adding this requires a change to data/books.xsd, and I also need to check that all the other tests which use this "Books List sample" work as required (S9APIExamples, cs/Examples, etc.)...

Still to do:

1. Sort out the .NET samples. It looks like we have not been adding the correct resources to the saxon-resources download (i.e. there is some problem in the build). The documentation http://saxonica.com/documentation/index.html#!samples/dotnetsamples refers to " three programs ExamplesHE.cs, ExamplesPE.cs, and ExamplesEE.cs" in the /samples/cs directory of the saxon-resources download. However, these have not been included in the 9.7 saxon-resources releases, instead it contains an old version Examples.cs (which is out of date - it refers to Saxon-SA and Saxon-B).

We need to ensure that the correct resources are in the download, and that they work properly.

2. Documentation updates. The "Sample Saxon Applications" section of the documentation (http://saxonica.com/documentation/index.html#!samples) could generally be improved - to add further useful information and better correlate with the samples supplied in the download.

Various updates to the documentation relating to the samples. In particular the "Sample Saxon Applications" (http://saxonica.com/documentation/index.html#!samples). Including:

• Rewritten first page to describe more of the sample resources provided in the saxon-resources download, e.g. mention more of the sample Java applications, and give documentation links

• Expanded the "Books List Example" page to describe other related resources included in the samples.

• Added a page for the S9APIExamples.java sample application.

Changes committed on 9.7 and 9.8 branches, and updated 9.7 documentation online (XML and HTML versions).

.NET samples updates. Tidied up ExamplesHE.cs, ExamplesPE.cs, ExamplesEE.cs, and SampleExtensions.cs:

• Check and correct test descriptions (in comments)

• Add mechanism to produce message for invalid supplied test name

• Ensure tests use licensed processor as necessary (XsltShowingLineNumbers, XQueryToStream, etc.)

• Add XPathSimple2 test to PE and EE, correct for HE

• XsltUsingRegisteredCollection - remove unused XdmNode input

• XQueryFromXmlReader - add output line to say "Output saved to testoutput2.xml"

• PE & EE XQueryTryCatch - use XQuery version 3.0 not 1.1

• EE XQueryUpdate - Change test so that books.xml is not really updated

• EE Validate - reinstate books-invalid.xml in samples; add message; fix to use schema awareness; fix case for valid document

• EE XPathSchemaAware - fix by adding XmlReaderSettings with DtdProcessing.Ignore

Committed changes under 9.8 branch (Saxon.Net directory) and added to 9.7 archive latest9.7/hen/csource/samples.

Build changes for cs samples (in build97 and build98):

• Added build of XPathExample.exe to build-n (in compile-samples-n task).

• Edited test-n to run up-to-date samples: ExamplesEE, ExamplesPE and ExamplesHE.