Project

Profile

Help

Bug #4984

The SQL extension element sources don't appear to ship in the source release

Added by Norm Tovey-Walsh 6 months ago. Updated 6 months ago.

Status:
New
Priority:
Low
Assignee:
-
Category:
-
Sprint/Milestone:
-
Start date:
2021-05-07
Due date:
% Done:

0%

Estimated time:
Legacy ID:
Applies to branch:
Fix Committed on Branch:
Fixed in Maintenance Release:
Platforms:

Description

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?

History

#1 Updated by Michael Kay 6 months 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.)

#2 Updated by Norm Tovey-Walsh 6 months 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.

Please register to edit this issue

Also available in: Atom PDF