https://saxonica.plan.io/https://saxonica.plan.io/favicon.ico2020-02-26T10:55:55ZSaxonica Developer CommunitySaxon - Bug #4466: Documentation on XInclude processinghttps://saxonica.plan.io/issues/4466?journal_id=149532020-02-26T10:55:55ZMichael Kaymike@saxonica.com
<ul></ul><p>There's also an incomplete list of parameters given at</p>
<p><a href="http://www.saxonica.com/documentation/index.html#!functions/fn/doc" class="external">http://www.saxonica.com/documentation/index.html#!functions/fn/doc</a></p>
<p>which doesn't include <code>xinclude</code></p> Saxon - Bug #4466: Documentation on XInclude processinghttps://saxonica.plan.io/issues/4466?journal_id=176772021-03-31T10:17:22ZDebbie Lockettdebbie@saxonica.com
<ul><li><strong>Assignee</strong> changed from <i>Michael Kay</i> to <i>Debbie Lockett</i></li></ul> Saxon - Bug #4466: Documentation on XInclude processinghttps://saxonica.plan.io/issues/4466?journal_id=177162021-04-01T10:49:25ZDebbie Lockettdebbie@saxonica.com
<ul><li><strong>Status</strong> changed from <i>New</i> to <i>In Progress</i></li></ul><ol>
<li>
<p>In fact, <code>sourcedocs/XInclude</code> was updated (commit on 2020-02-29) to "mention the possibility of requesting XInclude processing using query parameters on the URI.", so this got corrected in the Saxon 10 documentation with the 10.0 release (2020-03-16).</p>
</li>
<li>
<p>There is a comprehensive list of query parameters available when using the <code>fn:collection()</code> function at <a href="https://www.saxonica.com/documentation/index.html#!sourcedocs/collections" class="external">https://www.saxonica.com/documentation/index.html#!sourcedocs/collections</a> (under "Processing directories"), but indeed it would be good to add a corresponding list for the query parameters available when using <code>fn:doc()</code>. Having done this the link from <code>configuration/config-features</code>, under <code>RECOGNIZE_URI_QUERY_PARAMETERS</code> should be clarified.</p>
</li>
<li>
<p>Indeed <code>xinclude</code> needs to be added to the list at <code>functions/fn/doc</code>.</p>
</li>
<li>
<p>There is some confusion in the documentation about whether validation is specified using the query parameter <code>val=strict</code> or <code>validation=strict</code>. Referring directly to the <code>URIQueryParameters.java</code> source code, the correct key is <code>validation</code>, so there are a number of documentation references to fix.</p>
</li>
<li>
<p>In the fix for <a class="issue tracker-1 status-3 priority-2 priority-default closed" title="Status: Closed" href="https://saxonica.plan.io/issues/4476">Bug #4476: Type error evaluating (fn:collection(...))</a>, a new query parameter <code>content-type</code> was added for use in Saxon 10 (when using <code>fn:collection()</code>). This code was added just after the 10.0 release, on 2020-03-19, so became available from 10.1 (2020-05-14). The new parameter was added to the list at <code>sourcedocs/collections</code> in the documentation source, but intentionally commented out so that it would not be included in the documentation for 10.0. However we neglected to reinstate it for the 10.1 release. This should be fixed.</p>
</li>
</ol> Saxon - Bug #4466: Documentation on XInclude processinghttps://saxonica.plan.io/issues/4466?journal_id=177212021-04-01T16:38:01ZDebbie Lockettdebbie@saxonica.com
<ul><li><strong>Status</strong> changed from <i>In Progress</i> to <i>Resolved</i></li><li><strong>Applies to branch</strong> <i>10</i> added</li><li><strong>Fix Committed on Branch</strong> <i>10</i> added</li></ul><p>The four URI query parameters that are available for use with the <code>doc()</code> function are: <code>validation</code>, <code>strip-space</code>, <code>parser</code>, and <code>xinclude</code>.</p>
<p>Committed updates to the documentation source on Saxon 10 and trunk branches:</p>
<ul>
<li>
<code>xinclude</code> added to the list at <code>functions/fn/doc</code>, so that this list of the query parameters available is now complete (point 3 above)</li>
<li>Having done this, I decided not to add a new <code>sourcedocs</code> section with another copy of this list (and could not see an obvious section for it just to be added to). The vague link to <code>sourcedocs</code> from configuration/config-features, under RECOGNIZE_URI_QUERY_PARAMETERS, has been replaced with specific links to the relevant sections of <code>sourcedocs</code> for each of the 4 available query parameters. (This addresses point 2)</li>
<li>To enable this, a note about using the <code>parser</code> URI query parameter has been added to <code>sourcedocs/controlling-parsing</code> (because it wasn't otherwise mentioned there)</li>
<li>Fixed incorrect <code>val</code> references to the <code>validation</code> query parameter (point 4)</li>
<li>Reinstated documentation for new <code>content-type</code> <code>collection()</code> query parameter (point 5)</li>
</ul>
<p>Note no action required for point 1, so this addresses all issues of the bug.</p>
<p>The Saxon 10 documentation will be updated with the next maintenance release.</p> Saxon - Bug #4466: Documentation on XInclude processinghttps://saxonica.plan.io/issues/4466?journal_id=177852021-04-14T15:49:32ZO'Neil Delprattoneil@saxonica.com
<ul><li><strong>Status</strong> changed from <i>Resolved</i> to <i>Closed</i></li><li><strong>% Done</strong> changed from <i>0</i> to <i>100</i></li><li><strong>Fixed in Maintenance Release</strong> <i>10.5</i> added</li></ul><p>Bug fix applied to Saxon 10.5 maintenance release.</p>