Editorial activities

I've made the changes to fn:some and fn:all in GitHub, but it will probably take a few iterations to get the process working nicely.

Firstly, I committed some changes on the main branch, which you'll see on the "Code" tab at https://github.com/qt4cg/qtspecs - these were changes I made locally over previous months, and it wasn't feasible to separate them as individual commits.

Then I created a new branch for the fn:all and fn:some changes: see

https://github.com/qt4cg/qtspecs/tree/fn-all-some

If you look through the detail of what was changed:

* etc/XT40 is an index of section headings used by the build process. The change picked up here is an editorial change to the XSLT spec; I'm afraid I don't know why it's present on this branch.

* xpath-functions-40/src/function-catalog.xml contains the substantive changes. The format of this file is some way removed from the final HTML but you should get a gist of what has changed.

* merge-function-specs.xsl is a stylesheet that processes the function catalog. You wouldn't normally expect to see any changes here, but I introduced a new mechanism in the catalog for declaring that an argument to a function is optional with a default value, and the XSLT code has been changed to render this. (We might change the way it's rendered in due course, naturally).

* the change to xslt.xml shouldn't have been necessary on this branch, but I found that I'd created the branch before validating that the baseline was well-formed, so a change was needed.

Although I've created the branch on the server, I haven't actually created a pull request to merge it. In fact, I got some kind of authentication error when I attempted to do so.

Norm understands the technology of how the HTML specs are re-generated and I'll leave him to sort that out (I've run the build locally and checked the output, but it gets run again on the server using a continuous integration hook.)

Michael Kay
Saxonica

Received on Tuesday, 13 September 2022 17:44:49 UTC