Ready for a new release?

21 views
Skip to first unread message

Florent Georges

unread,
Sep 12, 2011, 8:16:15 AM9/12/11
to XSpec users list
Hi,

After a looong (too long) time, I think it is time for a new
release of XSpec. I've made a pre-3.0 release package and ZIP
archive, you can find them at, resp.:

http://fgeorges.org/tmp/xspec-0.3.0dev.xar
http://fgeorges.org/tmp/xspec-0.3.0dev.zip

Can you please have a look at them, and give any feedback in the
next couple of days? Without any comment, I'll release 0.3.0
officially, with the following change list (if you think about
something else that changed since 0.2, please tell me):

- improved XQuery support
- delivered as an EXPath package
- new tests (of XSpec itself)
- numerous bug fixes
- improved shell scripts
- new XProc harnesses for several processors

Regards,

--
Florent Georges
http://fgeorges.org/
http://h2oconsulting.be/

Marc van Grootel

unread,
Sep 12, 2011, 1:45:27 PM9/12/11
to xspec...@googlegroups.com
Hi Florent,

Thanks for all the work, great to see a new release.

One comment about the xspec.bat

I think it still needs to have a couple of quotes put in:
line 53: ... -xsl:"%~dp0\generate-xspec-tests.xsl"
line 77: ... -xsl:"%~dp0\format-xspec-report.xsl"

I had the tutorial xspec fail once I had put the whole xspec package under the Oxygen framework dir. Adding these quotes fixed it.

One major gripe I had with the previous xproc harness was that it would not display the xslt compilation error output and only displayed a cryptic xproc error. I'm happy to see that now it does display them and the harness runs fine within Oxygen.

--Marc
--
--Marc

Tony Graham

unread,
Sep 13, 2011, 1:35:13 PM9/13/11
to xspec...@googlegroups.com
On Mon, September 12, 2011 1:16 pm, Florent Georges wrote:
...

> Can you please have a look at them, and give any feedback in the
> next couple of days? Without any comment, I'll release 0.3.0
> officially, with the following change list (if you think about
> something else that changed since 0.2, please tell me):
>
> - improved XQuery support
> - delivered as an EXPath package
> - new tests (of XSpec itself)
> - numerous bug fixes
> - improved shell scripts

improved shell scripts and Ant build file

> - new XProc harnesses for several processors

oXygen framework for editing?
Emacs nXML-mode 'schemas.xml' file???

Regards,


Tony.

Marc van Grootel

unread,
Sep 13, 2011, 2:40:24 PM9/13/11
to xspec...@googlegroups.com
Hi,

I attached my Oxygen .framework and templates dir. I'm still on Oxygen 11 not sure if it works for 12 or 13.
The .framework is configured to use the XProc harness.

It's not ideal yet though
- I've configured one fixed absolute path to send the reports to, others may prefer putting the report next to the .xspec itself, or send it to a fixed directory relative to the project url, ${pdu} but the directory has to exist, the XProc will not create it for you.
- the xspec-home option is also an absolute path because in Oxygen 11 the option values do not accept the ${..} variables.
Both need to be changed manually.

Works really well for me and is quite a lot faster than calling an external script or ant build file.

--Marc

On Tue, Sep 13, 2011 at 7:35 PM, Tony Graham <dev....@menteithconsulting.com> wrote
oxygen.zip

Marc van Grootel

unread,
Sep 14, 2011, 4:24:23 AM9/14/11
to xspec...@googlegroups.com, geo...@oxygenxml.com
Hi,

George Christian Bina graciously donated an Oxygen 13 license so here are the .framework file and templates dir for Oxygen 13.

This file doesn't have hard-coded absolute paths in them. The xspec-home option to the XProc script is now using a variable.
Also, in v13 the output directory is automatically created if it doesn't already exist.

There are probably different preferences of where you want the HTML report located. I prefer not to have them next to the .xspec because they might accidentally wind up in version control. However, that is the setting I used here. You may want to customize that. Otherwise it's good to go.

Thanks George!

--Marc




oxygen13.zip

Tony Graham

unread,
Sep 14, 2011, 5:30:28 AM9/14/11
to xspec...@googlegroups.com
On Wed, September 14, 2011 9:24 am, Marc van Grootel wrote:
> George Christian Bina graciously donated an Oxygen 13 license so here are
> the .framework file and templates dir for Oxygen 13.

There is an oXygen 11 framework file in Subversion. See
http://code.google.com/p/xspec/source/browse/#svn%2Ftrunk%2Feditors%2Foxygen

> This file doesn't have hard-coded absolute paths in them. The xspec-home
> option to the XProc script is now using a variable.
> Also, in v13 the output directory is automatically created if it doesn't
> already exist.

Your framework appears to expect the complete XSpec distribution under
${frameworks}/xspec/src/. Is that correct?

> There are probably different preferences of where you want the HTML report
> located. I prefer not to have them next to the .xspec because they might
> accidentally wind up in version control. However, that is the setting I
> used
> here. You may want to customize that. Otherwise it's good to go.

The other framework, after running the Ant build file, only provided the
schema. There are references in the build.xml file to css and templates
directories, but I can't remember ever doing anything with them. Given
how the scope of XSpec has expanded, I think it is useful to do as you
have done and include all of XSpec under the oXygen framework.

I think that implies that there could be a second form of the XSpec
distribution as an oXygen framework (though maybe not as part of the new
release) so that users only have to install one thing (and so George can
just pick it up and bundle it with oXygen and so further spread XSpec
usage). What do others think?

Regards,


Tony.

Marc van Grootel

unread,
Sep 14, 2011, 7:10:15 AM9/14/11
to xspec...@googlegroups.com
Hi Tony,

Yep, I assume the complete framework there. Out of lazyness I just added a templates dir and the framework file.
I saw the one in SVN but it didn't contain a transformation scenario. I think that a long time ago I used that and added the transformation scenario.

Having it bundled would be even better.

--Marc

Florent Georges

unread,
Sep 14, 2011, 8:27:48 AM9/14/11
to xspec...@googlegroups.com
On 12 September 2011 19:45, Marc van Grootel wrote:

> I think it still needs to have a couple of quotes put in:
> line 53: ... -xsl:"%~dp0\generate-xspec-tests.xsl"
> line 77: ... -xsl:"%~dp0\format-xspec-report.xsl"

Fixed. Dank u wel !

Florent Georges

unread,
Sep 14, 2011, 8:28:44 AM9/14/11
to xspec...@googlegroups.com
On 13 September 2011 19:35, Tony Graham wrote:

> improved shell scripts and Ant build file

> oXygen framework for editing?
> Emacs nXML-mode 'schemas.xml' file???

Good catch, thanks!

Florent Georges

unread,
Sep 15, 2011, 5:59:21 AM9/15/11
to xspec...@googlegroups.com
On 13 September 2011 20:40, Marc van Grootel wrote:

Hi,

> I attached my Oxygen .framework and templates dir

Thanks to you and Tony for this interesting discussion. Tighter
integration of XSpec within oXygen (and any other IDE, by the way)
is indeed very important. As this is not a trivial change and
more like a new feature, I suggest to discuss it more thoroughly
after the next release:

http://code.google.com/p/xspec/issues/detail?id=39

Reply all
Reply to author
Forward
0 new messages