Dear Jack,
My confusion mainly arises from the documentation for the Database Module in the XQuery portal (http://docs.basex.org/wiki/Database_Module). Throughout this page, the examples provided for the functions seem to indicate that it is possible to provide a single name which maps to a single document-node.
we have added one introductory paragraph "Commonalities" on that page that is supposed to explain the $db variable, but it may well be that it's not really noticed, or may be misleading.
When I find more time, I can provide more detailed recommendations for the above wiki page.
That would be great; you'll probably be more efficient in rephrasing the relevant snippets than us (maybe it's just one, two sentences that may need to be replaced).
"Checks if the specified resource exists and if it is an XML document". That being the case, I would think it would return false if my path argument actually contained two document-nodes.
Do your documents have the same name?
In fact, it would seem from some quick tests that I am even able to store binary resource and XML under the same path (which I would expect with folders but not with documents).
True, that's currently possible (but may be prohibited in future versions).
I hope this is useful. I still think that having a true document-node to document mapping would be useful, as it would allow one to use the handy database module functions such as add, delete, rename, and replace confidently.
What would have to be changed in your opinion to end up with a true document-node to document mapping?
Thanks, Christian