This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 28294 - [XP3.1] 2.4.4 Input Sources informal description
Summary: [XP3.1] 2.4.4 Input Sources informal description
Status: RESOLVED FIXED
Alias: None
Product: XPath / XQuery / XSLT
Classification: Unclassified
Component: XPath 3.1 (show other bugs)
Version: Candidate Recommendation
Hardware: PC Linux
: P2 minor
Target Milestone: ---
Assignee: Jonathan Robie
QA Contact: Mailing list for public feedback on specs from XSL and XML Query WGs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-03-23 00:59 UTC by Patrick Durusau
Modified: 2015-07-11 18:23 UTC (History)
1 user (show)

See Also:


Attachments

Description Patrick Durusau 2015-03-23 00:59:59 UTC
2.4.4 Input Sources

"The input functions are described informally here; they are defined in [XQuery and XPath Functions and Operators 3.1]."

Followed by a bulleted list of input functions supported by XPath 3.1 with informal definitions, 

http://www.w3.org/TR/xpath-functions-31/#fns-on-docs defines:

14.8.1 fn:doc
14.8.2 fn:doc-available
14.8.3 fn:collection
14.8.4 fn:uri-collection
14.8.5 fn:unparsed-text
14.8.6 fn:unparsed-text-lines
14.8.7 fn:unparsed-text-available
14.8.8 fn:environment-variable
14.8.9 fn:available-environment-variables

A differently ordered listing in 2.4.4 makes comparison more difficult than otherwise necessary.

I take it that XPath 3.1 does NOT support fn:doc-available and fn:unparsed-text-lines?

Wouldn't it be better to use the same list order as in Functions and to note the omissions?

Not to mention dropping the informal definitions in favor of the ones in Functions. Reasoning partial information isn't as useful as complete information.

"These input functions are all specified in [XQuery and XPath Functions and Operators 3.1], which specifies error conditions and other details not described here."

Why the second reference to [XQuery and XPath Functions and Operators 3.1]?
Comment 1 Jonathan Robie 2015-07-11 18:23:14 UTC
Done.