This package provides classes for users who need finer control on structured text handling. In particular, the user should use the methods in the ISTextExpert class in the following cases:

- The structured type handler to use is not one of those predefined in {@link STextTypeHandlerFactory}.
- A non-default {@link environment} needs to be specified.
- A call to a method processing a piece of text may create a state which affects the processing of the next piece of text.
- The user needs to manage the offsets where directional formatting characters are inserted in the text.

Note that the basic functions are provided in package {@link org.eclipse.equinox.bidi} and its {@link STextProcessor} class.

To access the more sophisticated methods for processing structured text, the user should proceed as follows:

- The user has to obtain an appropriate `ISTextExpert` instance using the methods in STextExpertFactory.
- The user may then invoke the more sophisticated methods provided by ISTextExpert for processing the structured text.
- If those methods should work in an environment different from the default, the user may specify properties of the environment using the class STextEnvironment.

  This should be done before obtaining a `ISTextExpert` instance, and the specific environment must be specified when invoking `STextExpertFactory` methods. This will associate a type handler with the given environment and provide a customized `ISTextExpert` instance to the user.