Bug #3108
closed
Configuration file documentation and schema improvements
Fix Committed on Branch:
9.7, trunk
Fixed in Maintenance Release:
Description
Opening this bug to record general improvements to do with the configuration file.
While working on two current bugs regarding specific issues with the configuration file documentation and the schema (https://saxonica.plan.io/issues/3073 and https://saxonica.plan.io/issues/3088), a number of other minor issues have arisen. This bug will be used to document the various changes made to resolve these.
- Improve consistency checks between FeatureKeys.xml and configuration file schema config.xsd:
The stylesheet FeatureKeysToSchema.xsl which is used to generate the annotated schema annotatedConfig.xsd includes a check that all attributes defined in the schema are defined in FeatureKeys.xml. Add the converse check: that all features defined in FeatureKeys.xml that should be defined in the schema, are defined there. i.e. Apart from a defined exceptions list of the features which can not be set from a configuration file (e.g. the feature CONFIGURATION_FILE), if some feature defined in FeatureKeys.xml is not defined in the schema, then a warning is produced.
-
Using the solution to 1, add xslt/@enableAssertions (9.7 and 9.8) and xslt/@resultDocumentThreads (in 9.8, but not 9.7) to schema:
-
Other minor corrections in FeatureKeys.xml and AdditionalFeatures.xml for configuration file documentation:
- Improve build scripts for generating samples download and documentation:
Add touches in documentation/gen-doc target to force update for configuration file documentation.
Add touch in samples-common target to force regeneration of annotatedConfig.xsd.
- Status changed from New to In Progress
- Fix Committed on Branch 9.7, 9.8 added
All fixes as described above committed on 9.7 (except as noted) and 9.8 branches. Documentation updated online as required.
- Status changed from In Progress to Resolved
Marking this bug as resolved now. Work for 9.7 is complete. Further work for the 9.8 versions is required (to get things up-to-date), but that is development work and will be done in due course (with assistance from the changes made and described above).
There has been one further related change recently: Validation tests for the sample configuration files against the schemas have been added to our samples testing ANT script: see test-cmd-config in the testing-j build file. Added for 9.7 and 9.8.
- Status changed from Resolved to Closed
- % Done changed from 0 to 100
- Fixed in Maintenance Release 9.7.0.18 added
Bug fix applied in the Saxon 9.7.0.18 maintenance release.
- Fix Committed on Branch trunk added
- Fix Committed on Branch deleted (
9.8)
- Applies to branch deleted (
9.8)
Please register to edit this issue
Also available in: Atom
PDF