Project

Profile

Help

Bug #4221

closed

Distinct options for Query.exe from command line help and in Documentation

Added by Boris Lehečka almost 5 years ago. Updated over 4 years ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
Diagnostics
Sprint/Milestone:
-
Start date:
2019-05-16
Due date:
% Done:

100%

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

Description

When comparing options for Query.exe (Query.exe -?) and options in Documentation (https://www.saxonica.com/documentation/index.html#!using-xquery/commandline) there are some discrepancies:

Options available from command line help, not mentioned in the Documentation:

  • -pipe
  • -qversion

Options mentioned in the Documentation, not available from command line:

  • -TB
  • --feature
Actions #2

Updated by Michael Kay almost 5 years ago

Thanks for reporting this.

In the command line help, I don't see either -pipe or -qversion in 9.9. The -pipe option was last seen in 9.8, while -qversion was last seen in 9.7.

-TB is available in 9.8 and 9.9 but not in 9.7.

I suspect you are loading the wrong version (check the -t output)

We should add a mention of --feature, and perhaps an option --? to enumerate all features.

Actions #3

Updated by Boris Lehečka almost 5 years ago

Dear Michael,

you are right, I've compared (by mistake) Saxon-HE v. 9.7 with Documentation of 9.9 version.

After comparing current versions of command line help and Documentation, results are as follows:

Options available from command line help, not mentioned in the Documentation:

  • -Tlevel
  • -Tout

Options mentioned in the Documentation, not available from command line:

  • --feature

Options -Tlevel and -Tout are described in the Documentation in the section Saxon Change History (https://www.saxonica.com/documentation/index.html#!changes/command-line/9.7-9.8).

An option -? is available in the Documentation, but as the last option in the list, while in the command line help is on the 1st place.

Actions #4

Updated by Michael Kay almost 5 years ago

Been testing -Tlevel and -Tout in 9.9

For XQuery both seem to work OK; I have updated the documentation on the trunk.

For XSLT, -Tlevel:none outputs context node changes, which seems inappropriate. -Tout has no effect, although it is listed in the command line help.

Changed -Tlevel:none to stop outputting context node changes.

Trying to get -Tout working for Transform causes problems, because there seems to be interaction with the -traceout option.

Actions #5

Updated by Michael Kay almost 5 years ago

  • Category set to Diagnostics
  • Status changed from New to Resolved
  • Assignee set to Michael Kay
  • Priority changed from Low to Normal
  • Applies to branch trunk added
  • Fix Committed on Branch 9.9, trunk added

Fixed -Tout on the development branch. Not fixing it on the 9.9 branch because it's too risky in the absence of a specific user-reported bug.

Actions #6

Updated by Debbie Lockett almost 5 years ago

Updated the documentation on the trunk to also include -Tlevel and -Tout for XSLT.

Updated 9.9 documentation source to include -Tlevel and -Tout for XQuery, and -Tlevel (but not -Tout) for XSLT. (To be updated online with next maintenance release.)

Actions #7

Updated by O'Neil Delpratt over 4 years ago

  • Status changed from Resolved to Closed
  • % Done changed from 0 to 100
  • Fixed in Maintenance Release 9.9.1.4 added

Bug fix applied in the Saxon 9.9.1.4 maintenance release

Please register to edit this issue

Also available in: Atom PDF