Hello,
It is incomplete, to my usage scenario. For example, the wiki page does not show an example with the localhost as part of the url.
It is not incomplete, such a construct simply does not exist and it can not be executed this way (hence, we do not have an example for that...). It also does not make much sense: Imagine, you would write something like "ftp://....." as your path - RestXQ can not, of course, magically change the protocol. This is done on a different layer, i.e. the server.
Let suppose you want your final URL (which you use to access the page in the browser) to be http://localhost:8984/xmldatabasefile.xml/bookstore/book
This consists of two parts: The first one is the server url mapping, where all RESTXQ URIs are bound to. In this case, this would be http://localhost:8984/
The second part is the path given as RESTXQ annotation, in this case xmldatabasefile.xml/bookstore/book
So you should instead use the annotation %rest:path("xmldatabasefile.xml/bookstore/book")
to access your ressource at the URL given above, assuming you are binding RESTXQ execution to the root of your server, which is running on localhost:8984 (this is the default).
Cheers, Dirk