Applications of OpenSP

The OpenSP library has been used in a number of projects. The World Wide Web consortium on-line HTML and XHTML validator is based on the OpenSP library. In addition to the OpenSP library a set of command line tools are provided to support the validation and transformation of SGML files. In particular onsgmls can validate both XML and SGML documents held on a local file system or accessed remotely via a web server using the HTTP protocol with standard URI notation; osx will convert SGML to XML to allow a library of SGML documents to be processed with XML tools.

Obtaining OpenSP

OpenSP is a project hosted at sourceforge.net and is available from the OpenJade web site at http://openjade.sourceforge.net or directly from the OpenJade project page at http://sourceforge.net/projects/openjade

OpenSP is provided in source code form. However the project is moving towards the provision of pre-compiled binary packages for common platforms. These can be expected to appear shortly after a given source release. Any help to ensure that the widest array of platforms is support is always greatly appreciated.

Supported Platforms

OpenSP is intended to be as portable as possible. It should be possible to compile and build on most contemporary UNIX type platforms. In addition OpenSP should also build on Microsoft's Win32 based operating systems.

OpenSP is known to compile with both the GNU gcc c++ compiler and Microsoft Visual C++. Other compilers have not been extensively tested.

OpenSP 1.5.1 should build with the GNU gcc c++ compiler from version 2.95 up to version 3.3.

OpenSP has been built on a number of architectures including Intel i386 and ia64, Alpha AXP, Sparc, PPC and S/390.

The following table details known successful builds

Please report any successful builds not mentioned above to <openjade-devel@lists.sourceforge.net>, including any diffs/patches you have used.

Building OpenSP from Source

OpenSP requires 20Mb to 50Mb of disk space to build. An installation will require around 10Mb to 20Mb depending on architecture.

On UNIX platforms, OpenSP makes use of the GNU software configuration tools (autoconf, libtool, automake etc). The GNU C++ compiler and make utility should also be used. The steps required to build the OpenSP tools (onsgmls, osgmlnorm, ospam, ospcat, ospent, osx) and libraries are as follows:

gzip -d OpenSP-1.5.1.tar.gz | tar xvf -
cd OpenSP-1.5.1
./configure [options…]
make

make install

./configure --help

onsgmls -s http://www.example.com

Please refer to the system documentation for details on building on the Win32 platform.

Binary Distributions

In addition to binary packages availble from the project, OpenSP has been a part of many software distributions, including the major Linux distributions as well as FreeBSD. Expect pre-compiled and packaged versions of the latest version of OpenSP to be available from your distributor in due course.

Installation

In addition to the OpenSP executables and libraries you will also need various DTDs and declaration files. Some DTDs and associated files (entity definitions) are available in the pubtext directory of the distribution. However, more authoritative sources should be referenced to ensure that up-to-date versions are used. If you wish to process XML files, then suitable SGML declarations for valid XML documents should be used. Again, a sample set of declarations (xml.dcl) is provided in the pubtext, but more complete or recent versions may be available from other sources.

OpenSP supports the standard SGML catalog facility; it is recommended that you set up and use such a catalog system.

Support

If, after reading the documentation, you still have a problem, then you may require some additional help. The OpenJade project is a volunteer effort and as such does not provide any formal support. Instead, you should look to the community for support. Once part of the community, you, in turn, will be able to play your part in helping those that come after you. Here are some pointers to obtaining help:

• If you obtained your OpenSP distribution in binary form from your operating system distributor and you have a build related problem - such as onsgmls crashing, then your first port of call should be your distributor.

• If you have a problem with the usage of the OpenSP tools, then you should try the openjade-users mailing list, see http://sf.net/projects/openjade/ for details.

• If you have a patch or bug fix for OpenJade, or are trying to use the OpenSP API then the openjade-devel mailing list is the appropriate forum.

Please choose only one mailing list to post to, as cross-posting is generally frowned upon. The various mailing lists are archived and searchable. It is always worth searching for your problem first, as it is often the case that someone has had the same problem before.

Version 1.5.1

The following table details the major improvements in OpenSP 1.5

Version 1.5

The following table details the major improvements in OpenSP 1.5

Version 1.4

• Support for the koi8-r (RFC 1489) encoding.

• OpenSP now supports long (GNU Style) command line options.

• OpenSP is internationalized

• New option -h or --help shows a list of all available options with descriptions.

• New option -n and -x to see message numbers/relevant clauses with messages.

• More of Annex K of ISO 8879 supported: SGML declarations on subdocs, DATA declared value for attribures, DTD data entities and DTD notations for doctypes, complete IMPLYDEF support, ENTITIES REF constraints, URN parsing. Many new -w flags.

• DTDDECL support

• New spcat command line interface to the catalog manager.

Version 1.3.4

Changes in OpenJade 1.3.4

• Added the Entity classes to the public interface of the library/DLL.

Version 1.3.3

The first release from the OpenJade project