How to annotate deprecated modules

rhdunn / xquery-intellij-plugin

XQuery, XPath and XSLT Language Support for the IntelliJ IDE

https://rhdunn.github.io/xquery-intellij-plugin/

Apache License 2.0

25 stars 9 forks source link

How to annotate deprecated modules #160

Open CanOfBees opened 1 year ago

CanOfBees commented 1 year ago

Hi - I have been, very slowly, working my way through the last several BaseX versions and I find myself stuck on how to annotate the removal/deprecation of two of the BaseX modules, the Geo Module and the ZIP module.

It looks like the following is the appropriate syntax is the right approach:

declare option o:requires-import "basex/7.6; until=basex/10.0; location-uri=(none)";

but I'm not sure. The current geo.xqy seems to follow this.

Thanks for your thoughts!

rhdunn commented 1 year ago

Hi,

Currently, those annotations are not made use of by the plugin so are currently only informational. Your markup example looks good.

My plan is to eventually create versioned packages per http://expath.org/spec/pkg for the built-in function definitions for W3C, BaseX, eXist-db, and Saxon. (For MarkLogic I want to generate the package from the documentation zip.) This way, I can download and use the specific versions of the built-in definitions based on the user's configuration.