XMLLib osax 3.1.5, Read me
Home ▸ Documentation ▸ XMLLib osax 3.1.5, Read me

Preliminary note

• The XMLLib osax 3.1.5 works under MacOS X 10.5 and higher.
• For information and resources regarding XML, please visit www.w3.org.
• For information and resources regarding the osax, please visit www.satimage-software.com.
• The XMLLib osax, which is also available separately, is primarily a component included in the distribution of Smile. This is why there are no separate release notes for the osax. For the release notes for the XMLLib osax please refer to the release notes for Smile.

Overview

The XMLLib osax is a Scripting Addition, i.e. a plug-in for AppleScript. XMLLib osax implements the XML DOM in AppleScript. Features offered by the XMLLib osax include:

• opening, validating, closing, saving an XML document
• browsing an XML tree - parents, children, siblings
• searching an XML tree - sending a XPATH request
• editing, creating, removing an XML node
• applying a XSLT stylesheet
• handling XLinks

Whenever this makes sense XMLLib carries references rather than explicit data, so your script will be able to process arbitrarily large XML documents virtually as fast as if you had been writing a C program - yet, in a more comfortable environment.

XMLLib osax also includes a similar set of commands to work with Property lists (p-lists). You can transparently store AppleScript objects in p-lists. XMLLib's p-list commands provide a fast lookup table (or "dictionary", or "associative array") structure.

Users of Smile: you can use Smile as your XML editor, provided you work with Unicode files: UTF-8 (recommended) or UTF-16 files. Smile opens such XML files in Unicode windows. In Unicode windows, pressing Enter (⌅) checks the xml syntax, and pressing cmd-Enter (⌘⌅) validates the document with respect to its DTD.

Documentation

The documentation for XMLLib's commands is available on the Web, it's really one chapter of the documentation of Smile:

• the XML and property lists

Users of Smile: the documentation for XMLLib's commands is in your machine. To open it, select Help > Smile help and visit the Table of contents. Or, in Smile, select a word of the XML Suite, for instance XMLOpen, then pull down the contextual menu (ctrl-click.)

Technical support and feedback

• To report a bug, to suggest an improvement, or to ask for help, use the Technical support for Smile.
• Subscribe to the discussion list for Smile: visit the home page of sul, Smile Users List.

Distribution and property

This software is distributed by Satimage-software on a feedbackware basis. Before using it you must agree with the licensing terms for our free software.

In short, these terms specify that you owe us your feedback, and that you can integrate this software in a product or yours provided you state clearly enough that you are doing so.

Acknowledgments

A sincere thank is extended to those who reported bugs, offered suggestions, or collaborated with us at any level. A particular coup de chapeau to the members of SUL, whose feedback boosted the public release of the osax.

Disclaimer

In no event will Satimage-software be liable for any consequences of the use or of the lack of use of this software.

Version française

Copyright ©2011 Paris, Satimage