The SQL extension element sources don't appear to ship in the source release
The Saxon resources ZIP file includes JavaDoc for the
net.sf.saxon.option.sql.* extension elements, and they are present in the HE mirror repository, but they don't appear in the sources zip file.
Is that intentional, or an oversight?
Updated by Michael Kay over 1 year ago
I think it might have been by intent: IIRC the idea was that the issued sources.zip contains the minimum that you need to rebuild Saxon-HE as issued (source code after preprocessing, for example) and nothing else, while the repository contains everything you are entitled to under the open source license.
We issue the SQL extensions as open source code largely to acknowledge the fact that much of the code originally came from third-party contributors. On the reasonable assumption that they licensed the code to us under the Mozilla Public License, we are obliged to make available any modifications that we make to the code, even if we only use it in the commercial products. (A curiosity of the MPL is that we are actually only obliged to make the modified code available to our commercial customers, but it's fairer and easier to make it available to everyone.)
Updated by Norm Tovey-Walsh over 1 year ago
Okay. The reason I discovered this was a user reported a problem reading our documentation about how to write extension elements. That documentation uses the SQL extensions as an example and implies that the source code is available. Which it is, if you know exactly where to look. They failed to find it and ended up decompiling the class files to figure out the examples.
Seems like we should try to make that easier somehow.
Updated by Michael Kay 20 days ago
- Category set to Documentation
- Status changed from New to Resolved
- Assignee set to Michael Kay
- Applies to branch 11, trunk added
- Fix Committed on Branch 11, trunk added
I have amended the documentation for the SQL extension instructions to include a link to the repository.
Please register to edit this issue