Stylus Studio® 6 XML Enterprise Edition Release 3 (Build 377)
Release Notes

These release notes contain information specific to Stylus Studio® 6 XML Enterprise Edition Release 3 Build 377.

Installation Information — The readme.htm describes platform support and system requirements for Stylus Studio. By installing this release you agree to accept the terms and conditions of the Stylus Studio End User Product License Agreement. A copy of this Agreement can be found in the license.txt.

Contents

These release notes contain the following sections:

• What's New in Stylus Studio 6 XML Enterprise Edition Release 3

• Known Issues with This Release

• Installing DataDirect SequeLink Server

• Third-Party Code

What's New in Stylus Studio 6 XML Enterprise Edition Release 3

Here are just some of the features available in Stylus Studio 6 XML Enterprise Edition Release 3:

• Java Code Generation — Stylus Studio 6 XML Enterprise Edition allows you to quickly and easily generate Java code for any XQuery or XSLT document. You can generate Java code for one or more scenarios at the same time, and you can specify options such as the package and class names. Generated code is automatically added to the current project by default. To get started, select XSLT > (or XQuery >) Generate Java Code from the Stylus Studio menu.
• EDIFACT to XML Schema — A new Document wizard, EDIFACT to XML Schema, allows you to create an XML Schema (.xsd) from an EDIFACT (.edi) document.
• XML Schema Diagram Enhancements
• View Sample XML allows you to view an XML fragment that is based on element and attribute nodes in an XML Schema diagram. Just right-click on the node and select View XML Sample. You can optionally open these samples as new documents in the XML Editor.
• The Diagram tab in the XML Schema Editor has a feature that allows you to display the text associated with the xsd:documentation elements defined in your XML Schema. Click the Show Documentation button, or select Diagram > Show Documentation from the menu.
• Convert XML Schema to XML — A new Document wizard, XML Schema to XML, allows you to create an XML document from an XML Schema (.xsd).
• New XML Schema Documentation Stylesheet — The Documentation tab in the XML Schema Editor now allows you to choose from the default stylesheet, XS3P, and XSDdoc, which renders the XML Schema with a look-and-feel similar to Javadoc.
• File Explorer — The File Explorer window provides an alternative way to open files in Stylus Studio, as well as to perform other basic file-oriented operations (delete, copy, and rename, for example). You can also convert files by dragging the file you want to convert onto a user-defined Convert to XML file (.conv) or one of Stylus Studio's built-in adapters.
• XQuery Validation — XQuery processing results can now be optionally validated against any XML Schema you specify.
• W3C XQuery April 2005 Compliant — XQuery support in Stylus Studio Release 3 complies with the April 2005 W3C XQuery Working Draft.
• XSLT Validation — You can now optionally specify XML Schemas against which you want to validate the XML document that results from XSLT processing.
• Text View in XML Diff — The XML Diff Viewer has a third way to view differences in XML documents. In addition to the Split View - Tree tab and the Merged tab, you can now view two documents side-by-side in plain text on the Split View - Text tab.
• Canonical XML — A new feature, Make Canonical XML, allows you to convert an XML document to its canonical form. This feature is also available on the XML Editor tool bar.
• Options Dialog Box Enhancements — The Options dialog box (Tools > Options) has been simplified to provide easier access to default tool settings, settings for processors and validation engines, and default Stylus Studio file types. A handy bookmark feature remembers the Options page you last visited.
• Generate JAXB from XML Schema — You can generate JAXB (Java Architecture for XML Binding) application class files from an XML Schema. The generated application skeleton (Main.java, for example) demonstrates how to use Marshaller and Unmarshaller classes. To get started, open an XML schema, and select XMLSchema > Generate Java Binding Classes from the Stylus Studio menu.
• Auto-Backup — Stylus Studio now optionally creates backup files (*.bak) of your documents when you save them. You can turn off the backup feature on the Application Settings page of the Options dialog box.
• Continued Code Enhancements —Ongoing enhancements to features and performance.

Known Issues with This Release

This release has the following known issues:

• Built-In XSLT Processors
• XPath 1.0 Processor Limitations
• Miscellaneous

Built-In XSLT Processor Limitations

The limitations listed in this section do not apply to the Saxon, XalanJ, and MSXML .NET XSLT processors. These processors are fully supported for processing and debugging in this release.

The Stylus Studio built-in XSLT processor supports the W3C XSLT Recommendation except for the following features:

• xsl:apply-imports instruction.
• xsl:number localization features.
• Some xsl:output attributes. The following xsl:output attributes have no effect: version, standalone, cdata-section-elements, media-type. The following xsl:output attributes are supported: method, indent, encoding, doctype-public, and doctype-system.
• xsl:preserve-space instruction.
• xsl:strip-space instruction. While Stylus Studio does not support the xsl:strip-space instruction, Stylus Studio automatically strips text nodes that contain only white space.
• Simplified stylesheet syntax described in the XSLT Recommendation, Section 2.3. (The simplified syntax is not needed when you are using Stylus Studio to edit a stylesheet.)
• xsl:sort attributes lang and case-order.
• Extension element mechanism described in the XSLT Recommendation, Section 14. (Stylus Studio does support the extension function mechanism.)

Use of the format-number() function requires a JVM that is installed on your system and accessible by Stylus Studio.

XPath 1.0 Processor Limitations

The Stylus Studio XPath processor implementation includes a behavior that deviates from the XPath 1.0 recommendation. This behavior, however, is consistent with the DOM data model.

• Adjacent text and/or CDATA nodes are not merged.
• The DOM data model allows sequences of text nodes. The XPath data model does not. If a sequence of text nodes appears in an XML document, the XPath recommendation specifies that an XPath processor should process them as one text node.
• The Stylus Studio XPath processor returns consecutive text nodes as multiple, distinct text nodes.

Miscellaneous

• When Stylus Studio processes a stylesheet that declares a CDATA section as the value of a variable, Stylus Studio converts the CDATA section to text.
• When Stylus Studio reads an XML or XSL file that contains all English characters, it defaults to a font that cannot display Japanese. If you add Japanese characters and then save, close, and reopen the document, Stylus Studio uses a font that can display the Japanese characters.
• Javadoc for the custom file system API is unavailable at this time.

Installing DataDirect SequeLink Server

This section describes how to install DataDirect SequeLink Server. You need to install DataDirect SequeLink Server if you want to create a DB-to-XML data source for a database that is not already supported by Stylus Studio (such as Microsoft Access, for example). You need only to install the SequeLink Server; the SequeLink Client is installed automatically, as part of the Stylus Studio installation.

Executables and User Documentation

The installation executables and user documentation for DataDirect SequeLink Server is available as a Stylus Studio download. This link downloads a self-extracting file to your computer. When you run the file, it unpacks the installation setup.exe file and user documentation for DataDirect SequeLink Server to the location you specify.

Installation Summary

1. Obtain the DataDirect SequeLink files from the Stylus Studio download page or installation CD-ROM.
2. Read the DataDirect SequeLink user documentation.
3. Run the DataDirect SequeLink Server setup.exe.

When the installation is complete, the ODBC drivers you configured are available as DB-to-XML data sources in the Database Type drop-down list in the DB-to-XML Data Source editor.

A more detailed description of this process can be found here: http://www.stylusstudio.com/configure_data_source.html.

Third-Party Code

This release includes the following third-party software:

• XSLT software developed by the Apache Software Foundation
• Xerces C++ XML Parser and Xerces-J Java Parser, also from Apache
• FOP, also from Apache
• Dave Raggett's HTML Tidy
• Saxon XSLT and XQuery Processor from Saxonica Limited (http://www.saxonica.com/)
• xsddoc from <xframe>
• GNU Aspell
• Tim Bray's Genx
• IBM's International Components for Unicode (ICU)
• Trang Schema converter, from Thai Open Source Software Center, Ltd.
• XML Schema Validator (XSV), developed at the Language Technology Group of the Human Communication Research Centre in the Division of Informatics at the University of Edinburgh, with support from the World Wide Web Consortium.
• DTDs and XML Schemas developed by the World Wide Web Consortium (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University).
• Pathan, from DecisionSoft Limited
• Info-ZIP

Stylus Studio® 6 XML Enterprise Edition Release 3 (Build 377) - relnotes.htm