I wanted to look up the hof:until[1] syntax in the wiki. It tells me that it has been replaced with fn:iterate-while. Well, I hope, when the dust settles, there is something similar to this in the spec, but it looks like it may not be iterate-while .
Today a user of the current BaseX release(10.7) is going to struggle to find what hof:until does and wont find any fn:iterate-while . I think deprecating functions and moving forward is great. I do like to see what 4.0 might bring with the BaseX 11 betas but if I catch myself writing anything substantial I stop. The ground is unstable.
I think the wiki should center on the functionality of the current release, with just teasers about the future. Christian, I think you hinted that the future may hold some documentation API built into the product, or did I imagine that?
/Andy
[1] https://docs.basex.org/wiki/Higher-Order_Functions_Module,
Hi Andy,
Thanks for the raised finger. Indeed it’s the specification of XQuery 4 that takes much more time than anticipated. The process is highly dynamic, with confirmed features being revised again. Some weeks ago, we have stopped updating the old documentation, and we are working on a new one (completely based on XQuery, with the contents and history stored in databases). It will replace the old one and will be version-based, i.e., we’ll freeze the documentation of BaseX 11 (12, etc.) once it’s released and maintain the documentation for the upcoming version in parallel.
As BaseX 11 won’t be finalized until end of this month as originally planned, here’s a link to the new documentation, which we’re regularly updating:
The contents will stay, but the rendering is still work in progress. We’ve converted the contents to a mixture of XML and contemporary Markdown syntax;.editing works similar as before. I invite you (and everyone else) to ask for an account to be able to help us keeping the contents up-to-date and bug free.
We know ithe current state is a bit unfortunate. For those who are looking for a reliable version of the BaseX 10 documentation, we point to the archived PDF version:
https://docs.basex.org/wiki/Documentation
Hope this helps, Christian
Andy Bunce bunce.andy@gmail.com schrieb am Fr., 2. Feb. 2024, 19:25:
I wanted to look up the hof:until[1] syntax in the wiki. It tells me that it has been replaced with fn:iterate-while. Well, I hope, when the dust settles, there is something similar to this in the spec, but it looks like it may not be iterate-while .
Today a user of the current BaseX release(10.7) is going to struggle to find what hof:until does and wont find any fn:iterate-while . I think deprecating functions and moving forward is great. I do like to see what 4.0 might bring with the BaseX 11 betas but if I catch myself writing anything substantial I stop. The ground is unstable.
I think the wiki should center on the functionality of the current release, with just teasers about the future. Christian, I think you hinted that the future may hold some documentation API built into the product, or did I imagine that?
/Andy
[1] https://docs.basex.org/wiki/Higher-Order_Functions_Module,
Hi Christian,
Hope this helps
Sounds like a good way forward. Sign me up, please.
Digression: I made a tiny change to the wiki recently concerning the "Q" in expanded QNames [1] because I thought it was required. On reflection, this may be because I was using v9 at the time.
I now think the "Q" is required in BaseX v9, but optional in all V10+. Is this correct?
/Andy
[1] https://docs.basex.org/index.php?title=Command-Line_Options&curid=146&am...
On Sat, 3 Feb 2024 at 11:15, Christian Grün christian.gruen@gmail.com wrote:
Hi Andy,
Thanks for the raised finger. Indeed it’s the specification of XQuery 4 that takes much more time than anticipated. The process is highly dynamic, with confirmed features being revised again. Some weeks ago, we have stopped updating the old documentation, and we are working on a new one (completely based on XQuery, with the contents and history stored in databases). It will replace the old one and will be version-based, i.e., we’ll freeze the documentation of BaseX 11 (12, etc.) once it’s released and maintain the documentation for the upcoming version in parallel.
As BaseX 11 won’t be finalized until end of this month as originally planned, here’s a link to the new documentation, which we’re regularly updating:
The contents will stay, but the rendering is still work in progress. We’ve converted the contents to a mixture of XML and contemporary Markdown syntax;.editing works similar as before. I invite you (and everyone else) to ask for an account to be able to help us keeping the contents up-to-date and bug free.
We know ithe current state is a bit unfortunate. For those who are looking for a reliable version of the BaseX 10 documentation, we point to the archived PDF version:
https://docs.basex.org/wiki/Documentation
Hope this helps, Christian
Andy Bunce bunce.andy@gmail.com schrieb am Fr., 2. Feb. 2024, 19:25:
I wanted to look up the hof:until[1] syntax in the wiki. It tells me that it has been replaced with fn:iterate-while. Well, I hope, when the dust settles, there is something similar to this in the spec, but it looks like it may not be iterate-while .
Today a user of the current BaseX release(10.7) is going to struggle to find what hof:until does and wont find any fn:iterate-while . I think deprecating functions and moving forward is great. I do like to see what 4.0 might bring with the BaseX 11 betas but if I catch myself writing anything substantial I stop. The ground is unstable.
I think the wiki should center on the functionality of the current release, with just teasers about the future. Christian, I think you hinted that the future may hold some documentation API built into the product, or did I imagine that?
/Andy
[1] https://docs.basex.org/wiki/Higher-Order_Functions_Module,
I've sent you an e-mail in private.
The Clark notation for QNames with URIs was dropped. Instead, the Expanded QName syntax (which is also used in XPath and XQuery) is the one that is supported exclusively in the future:
-Q{URI}name
Andy Bunce bunce.andy@gmail.com schrieb am Sa., 3. Feb. 2024, 16:11:
Hi Christian,
Hope this helps
Sounds like a good way forward. Sign me up, please.
Digression: I made a tiny change to the wiki recently concerning the "Q" in expanded QNames [1] because I thought it was required. On reflection, this may be because I was using v9 at the time.
I now think the "Q" is required in BaseX v9, but optional in all V10+. Is this correct?
/Andy
[1] https://docs.basex.org/index.php?title=Command-Line_Options&curid=146&am...
On Sat, 3 Feb 2024 at 11:15, Christian Grün christian.gruen@gmail.com wrote:
Hi Andy,
Thanks for the raised finger. Indeed it’s the specification of XQuery 4 that takes much more time than anticipated. The process is highly dynamic, with confirmed features being revised again. Some weeks ago, we have stopped updating the old documentation, and we are working on a new one (completely based on XQuery, with the contents and history stored in databases). It will replace the old one and will be version-based, i.e., we’ll freeze the documentation of BaseX 11 (12, etc.) once it’s released and maintain the documentation for the upcoming version in parallel.
As BaseX 11 won’t be finalized until end of this month as originally planned, here’s a link to the new documentation, which we’re regularly updating:
The contents will stay, but the rendering is still work in progress. We’ve converted the contents to a mixture of XML and contemporary Markdown syntax;.editing works similar as before. I invite you (and everyone else) to ask for an account to be able to help us keeping the contents up-to-date and bug free.
We know ithe current state is a bit unfortunate. For those who are looking for a reliable version of the BaseX 10 documentation, we point to the archived PDF version:
https://docs.basex.org/wiki/Documentation
Hope this helps, Christian
Andy Bunce bunce.andy@gmail.com schrieb am Fr., 2. Feb. 2024, 19:25:
I wanted to look up the hof:until[1] syntax in the wiki. It tells me that it has been replaced with fn:iterate-while. Well, I hope, when the dust settles, there is something similar to this in the spec, but it looks like it may not be iterate-while .
Today a user of the current BaseX release(10.7) is going to struggle to find what hof:until does and wont find any fn:iterate-while . I think deprecating functions and moving forward is great. I do like to see what 4.0 might bring with the BaseX 11 betas but if I catch myself writing anything substantial I stop. The ground is unstable.
I think the wiki should center on the functionality of the current release, with just teasers about the future. Christian, I think you hinted that the future may hold some documentation API built into the product, or did I imagine that?
/Andy
[1] https://docs.basex.org/wiki/Higher-Order_Functions_Module,
basex-talk@mailman.uni-konstanz.de
-
Andy Bunce -
Christian Grün