Re: Want to produce for the first time a PR for a Spec - where to find description of the XML-schema of a Spec and about the whole process?

> To build the specs, simply type "gradle". That builds the whole thing, I
don't ever attempt any more specific build targets. The built specs will
appear in  qtspecs/build/www.

I tried:

java -jar C:\git\qtspecs\gradle\wrapper\gradle-wrapper.jar

But am getting waht appears to be an error message: "no main manifest
attribute, in C:\git\qtspecs\gradle\wrapper\gradle-wrapper.jar".

I also tried gradlew from the ,,,\qtspec directory, but am getting an error
again:

> Task :datamodel_merge
Validating
C:\git\qtspecs\build\expanded\xpath-datamodel-40\xpath-datamodel.xml
java.lang.UnsupportedClassVersionError: com/nwalsh/parsers/XJParse has been
compiled by a more recent version of the Java Runtime (class file version
55.0), this version of the Java Runtime only recognizes class file versions
up to 52.0




What should I do in order to run gradle successfully?

Thanks,
Dimitre

On Thu, Sep 28, 2023 at 9:56 AM Michael Kay <mike@saxonica.com> wrote:

> The basic schema (in the form of a DTD) is found in
> qtspecs/schema/xmlspec.dtd, which is further customised by
> qtspecs/schema/xsl-query.dtd. There are comments in these DTDs to help
> explain their usage, but frankly, I wouldn't want to rely entirely on the
> comments; it's much easier to find examples of what you want to do in the
> actual instance documents, and learn by example.
>
> There are some more specialised formats with their own schemas, for
> example grammar.dtd for the BNF grammar (XPath/XQuery plus XSLT patterns),
> and fos.xsd for the function catalog.
>
> The files you will want to edit are typically found in
> qtspecs/specifications/SPECNAME/src/*.xml. For some of the specs the text
> is split into multiple files; if you have difficulty finding the file
> containing the text you want to edit, then a directory search can be useful.
>
> I think most of the process documentation has been deleted because it was
> hopelessly out of date.
>
> There's no documentation specific to git, it is assumed that users are
> familiar with git working methods.
>
> To build the specs, simply type "gradle". That builds the whole thing, I
> don't ever attempt any more specific build targets. The built specs will
> appear in  qtspecs/build/www.
>
> If you have specific questions, don't be afraid to ask. Start with
> something fairly small so we can put you on the right path if you go astray.
>
> Michael Kay
> Saxonica
>
> > On 28 Sep 2023, at 16:55, Dimitre Novatchev <dnovatchev@gmail.com>
> wrote:
> >
> >
> > I have never before produced a PR for a Spec document and need
> guidance/resources about the files that are involved and their
> xml-schema/semantics.
> >
> > Can someone, please, help?
> >
> > Thanks,
> > Dimitre
> >
>
>