 |
|
|
|
||||
|
|||||
|
|
|||||
| Prerequisite Concepts | |||||
What's Changed |
|||||
Stilo makes every effort to ensure that new versions of OmniMark are backward compatible with programs written for previous versions. However, compelling design considerations sometimes make it necessary to change the language in a way that is not backward compatible with all existing programs. The following is a list of all such changes made since OmniMark 2.0, together with suggestions for making affected programs work with the current version of OmniMark.
The positional patterns value-start and value-end can now match multiple times on a string source. For example, test matches (value-start value-start) is now true.
Markup errors were interrupting pattern-matching in translate rules only if there was a markup-error rule in the program. Now they always interrupt the pattern-matching, regardless of the existence of markup-error rules.
When a string source function throws, its consumer used to be halted instantly. The throw is now delayed until the consumer finishes scanning of the terminated source.
When OMXERCES XML parser is used, all markup rules now complete their execution even after a fatal parsing error.
name of element and related syntax was accepted by the compiler in contexts where such code was guaranteed to fail at run-time (e.g., in a process rule). This is now a compile-time error. This change may cause certain programs that compiled under previous versions of OmniMark to no longer compile. However, such programs either contained code that was never executed, or would not execute successfully: there is no loss in functionality. The workaround is to remove the offending code.
A string source cast to a string was not being properly buffered. This fix can lead to changes in behavior. To obtain the old behavior, remove the string cast that precedes the string source expression.
The "%s_", "%st", and "%sn" format items now indicate that the character can be stripped by an "s" stream modifier, not that it should always be stripped.
OmniMark V8 is backward compatible with previous versions, with two exceptions. The first is that V8 has introduced new types and constructs which in turn makes some types obsolete. Use of these types in programs produces warnings but no change in functionality. Stilo encourages users to use the new syntax in new programs and to modify their existing programs to the new syntax, where it makes economic sense.
The second exception is external function libraries. External function libraries built to run with OmniMark V7 will not work with V8. This problem only affects customers who have built their own external function libraries. Users who only use Stilo supplied ones will not be affected.
This backward incompatibility resulted from the fix needed to stop a memory leak error in the External Function Interface. The fix to make V7 external function libraries usable with V8 is simple; just re-compile and re-link the libraries with the V8 SDK. Note that the SDK is now part of the V8 Development Package. There are no changes required to the existing library code.
Parentheses are no longer allowed around the list of arguments of the activate, deactivate, close, discard, and flush. Individual arguments may still be placed in parentheses. This change is necessary to allow unambiguous references to streams that are fields of records. Parenthesizing the entire argument list of these actions has never been required. Removing such parentheses will not affect program behavior.
External libraries compiled for version 6 or earlier must be recompiled in order to be compatible with version 7.
External libraries compiled for previous versions of OmniMark are not compatible with OmniMark 6. This includes both libraries supplied by OmniMark Technologies and third party libraries. Older libraries must be recompiled with the OmniMark 6 external function developers library before they can be used with OmniMark 6.
With the introduction of dynamic initializers, OmniMark no longer supports multiple global variable definitions. In earlier versions the following was legal:
global integer message-count
global integer message-count
Now this is not legal code. One of the declarations must be removed.
The builtins library is no longer distributed and log-message is now built into the language. Programs that used to include "builtins.xin" should no longer do so.
Variable name heralding was removed from the language. No longer supported are the -herald command-line option, the declaration declare heralded-names, or the keywords pattern and another. You can no longer use type names as heralds.
Programs that use variable name heralds rather than explicitly declaring variables must be rewritten to declare variables explicitly.
Programs that use variable name heralding to distinguish variables of the same name, but different types and scopes, must be rewritten to use unique variable names (where access to variables in the wider scope is required).
The rules for recognizing tokens have been changed, meaning that spaces are sometimes required between tokens where they were not required before. As a rule of thumb, always separate OmniMark tokens with spaces.
The rules for multi-value comparisons have changed. This was required to support operator overloading. The following sequence was true in previous versions, but will be false in this version:
do when "5" < "06" < 7
In previous versions, all comparisons were done by converting the values to numbers. In this version, the first comparison is a string-based comparison, because both its arguments are strings. The second is numeric, because it contains at least one number.
The default SGML declaration used by the SGML parser was changed to increase the values of certain key quantities such as NAMELEN. This could cause programs that attempt to validate SGML documents against the Reference Concrete Syntax to fail to report an error when any of these quantities exceeds the Reference Concrete Syntax default in the document being validated.
To fix programs with this problem, supply a copy of the SGML declaration for the Reference Concrete Syntax with the document you are validating.
The XML parser introduced in OmniMark 4.0 was written to a draft of the XML 1.0 specification and was incompatible with the 1.0 specification in some ways, most notably in its case-insensitive parsing of XML. The XML parser now complies with the XML 1.0 specification. This could cause programs to behave incorrectly if they do not use the correct case in markup names. It could also cause problems with input files that are not compliant with XML 1.0, but were compliant with the OmniMark 4.0 XML parser.
To fix programs with this problem, ensure that your markup names are typed correctly. Ensure that your XML files are compliant with the XML 1.0 specification.
Some programs may produce compiler error 2130, indicating that they contain potentially ambiguous attribute alias names. This is because of changes to the namecase general declaration. The namecase general and namecase entity declarations do nothing in OmniMark 5.2 and later. OmniMark now complies automatically with the NAMECASE GENERAL and NAMECASE ENTITY declarations in the SGML declaration. Earlier versions of OmniMark erroneously applied the namecase general declaration to attribute aliases. Attribute aliases are now always case insensitive. OmniMark will raise a compile-time error if this creates any ambiguity in your code. Note that this error will only occur if the namecase general no declaration is found in your program. So, if your program contains the namecase general no declaration, try to compile it once before removing the declaration to detect any potential ambiguity in your attribute alias names.
To fix programs with this problem, first check your use of attribute aliases to make sure there is no ambiguity, then remove the namecase general no declaration.
The initial size of variable-sized shelves was changed from 1 to 0. This will cause a run-time error in a program that assumes the default size is 1.
To fix programs with this problem, declare the affected shelves to have initial-size {1}.
The default program type was changed from the aided translation type "down-translate" to a normal or "process" program. Programs written as down-translate programs, but without the down-translate declaration at the top of the program, will compile but will do nothing.
To fix programs with this problem, add the following code at the top of the program:
down-translate
All variables must be declared. Programs that use heralded names but do not declare their variables will not compile.
To fix programs with this problem, declare all the variables.
To work around this problem, for versions up to 5.3, without altering the program, use the "-herald" command-line option. For later versions you will have to change your program.
|
Prerequisite Concepts What's new What was new What's fixed What was fixed |
Copyright © Stilo International plc, 1988-2008.
