Project

Profile

Help

Bug #5947

closed

Review the XQuery extensions documentation

Added by Debbie Lockett about 1 year ago. Updated about 1 year ago.

Status:
Closed
Priority:
Low
Category:
Documentation
Sprint/Milestone:
-
Start date:
2023-03-31
Due date:
% Done:

0%

Estimated time:
Legacy ID:
Applies to branch:
10, 11, 12, trunk
Fix Committed on Branch:
Fixed in Maintenance Release:
Platforms:

Description

The "Using XQuery" section of the documentation contains subsections on Extensibility and Extensions. These sections could definitely be improved.

Firstly there is duplication of information about XQuery extensions on these pages, which is confusing.

Also the information is out of date:

  • declare option saxon:default is still listed, though it was dropped in Saxon 9.6.
  • declare option saxon:allow-cycles is listed, though it was effectively dropped from Saxon 9.8 when support for XQuery 1.0 was removed. (Referring to the implementation in XQueryParser.parseOptionDeclaration, reveals that it is ignored, with a warning "Value of saxon:allow-cycles is ignored".)

We should also clarify which Saxon edition these extensions are available in. Referring to the implementations in XQueryParser it looks like:

  • declare option saxon:output is available in all editions
  • declare option saxon:memo-function requires PE or EE
  • the saxon:validate-type pragma requires EE

Please register to edit this issue

Also available in: Atom PDF