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?

Please, ignore the previous two messages.

I was able to build all specifications, after changing the JAVA_HOME to
point to a more recent version of Java.

Thanks,
Dimitre

On Thu, Sep 28, 2023 at 5:31 PM Dimitre Novatchev <dnovatchev@gmail.com>
wrote:

> > 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
>> >
>>
>>
>
>