W3C home > Mailing lists > Public > public-qt-comments@w3.org > October 2009

RE: [FO] Requesting enhancement of fn:doc()

From: Michael Kay <mike@saxonica.com>
Date: Fri, 16 Oct 2009 10:11:06 +0100
To: "'Loren Cahlander'" <loren.cahlander@gmail.com>, <public-qt-comments@w3.org>
Message-ID: <66565838F76F4D4AA582E87DF2E07E93@Sealion>
Thanks for subitting a comment on the spec.
 
I have lodged your comment in the bugzilla database at
 
http://www.w3.org/Bugs/Public/show_bug.cgi?id=7933
 
which means it will find its way onto the Working Group agenda.
 
I've also added my own personal comments suggesting why I don't think it's a
good idea - other WG members may well think differently.
 
Could I suggest that you sign up as a "CC" in the bug entry, which will
ensure that you are automatically kept up to date with the progress of WG
discussions on the request, and on its final disposition.
 
Regards,

Michael Kay
http://www.saxonica.com/
http://twitter.com/michaelhkay 


  _____  

From: public-qt-comments-request@w3.org
[mailto:public-qt-comments-request@w3.org] On Behalf Of Loren Cahlander
Sent: 13 October 2009 17:43
To: public-qt-comments@w3.org
Cc: Loren Cahlander
Subject: [FO] Requesting enhancement of fn:doc()


I would like to request that the specification of fn:doc() be changed to
match the implementation of that function by MarkLogic.


In MarkLogic, they deviated from the XQuery spec for the fn:doc() function
and it can return multiple documents based on a sequence of document URIs
passed into the function at one time.


http://developer.marklogic.com/pubs/4.1/apidocs/SequenceBuiltins.html#fn:doc


The eXist Open Source Database implements fn:doc() to the W3C specification
and has the function xmldb:document() that returns multiple documents

Here is the function documentation for xmldb:document() and fn:doc()

xmldb:document() can return multiple documents with a single call and
fn:doc() can only return one document at a time.

Another option would be to leave fn:doc() alone and add fn:docs() with the
multiple document URIs being passed in.


xmldb
  _____  

http://exist-db.org/xquery/xmldb
A module for database manipulation functions.
document
  _____  

xmldb:document($document-uris as xs:string+, ...) node()*
Returns the documents $document-uris in the input sequence. Collection URIs
can be specified either as a simple collection path or an XMLDB URI.If the
input sequence is empty, the function will load all documents in the
database.
$document-uris	 The document URIs	
		
  _____  

Returns the documents
  _____  

Deprecated: See the standard fn:doc() function This function could be
removed at anytime during the 1.5 development and will be removed in the 1.6
release.
  _____  

http://www.w3.org/2005/xpath-functions
A module with the XQuery/XPath Core Library Functions
doc
  _____  

doc($document-uri as xs:string?) node()?
Returns the document node of $document-uri. Resource URIs can be specified
either as a simple collection path, an XMLDB URI or any URI.
$document-uri	 The document URI	
  _____  

Returns the document node of $document-uri



Loren Cahlander
Enterprise Architect
Syntactica <http://www.syntactica.com/> 
Received on Friday, 16 October 2009 09:11:49 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:45:41 UTC