NAME

Version differences from the OLIT 3.0 release. 

DESCRIPTION

This section describes important changes that have been made to OLIT since version 3.0.  All OLIT developers should read this section. 

C++ Support

OLIT 3.0.1 fully supports the C++ programming language.  C++ programmers may use the OLIT API from within their programs.  OLIT provides bindings for C++ type-safe linkage.  OLIT supports the C++ release level of cfront 2.1 or later. 

NEW OLIT HEADER FILES

The OLIT 3.0.1 release includes new header files.  These files do not require special defines to compile an OLIT application.  For example, they do not depend on
-Dsun or -DSYSV. 

ANSI C, and K&R Support

The OLIT header files in OLIT 3.0.1 fully support C++, K&R C, and ANSI C.  They are free of syntactical macros and are therefore compatible with most software tools and utilities. 

Include Path

In the OLIT 3.0.1 release, you only need to specify the following include path:

-I$OPENWINHOME/include

OBSOLETE HEADER FILES

The following header files are obsolete and are not included in the OLIT 3.0.1 release:

 Accelerate.h
DisplayP.h
DynamicI.h
OlMinStr.h
OlXlibExt.h
OLStrings.h
SourceP.h
Text.h
TextP.h
TextPane.h
TextPaneP.h
TextPosP.h
TextShlib.h
VirtualP.h
 

The following header files which are private to the OLIT toolkit are no longer included:

 ColorChip.h
Converters.h
Error.h
OlDnDVCXI.h
OlDnDVCXP.h
OpenLookI.h
RootShellP.h
StringList
TextDisp.h
TextEPos.h
TextUtil.h
TextWrap.h
Util.h
VendorI.h
linkedList.h
memutil.h
olcursor.h
strutil.h
 

 
The following header files are obsolete, but are still included in the OLIT 3.0.1 release for backward compatibility:

 AbbrevStac.h
ButtonStac.h

STATIC LINKING

When you build your OLIT application statically, you must link the following libraries dynamically:

 -lsocket
-lnsl

 
For example:

% cc -Bstatic foo.c -o foo -lXol -lXt -lX11 -Bdynamic -lnsl -lsocket

VIRTUAL EVENTS

The virtual event mechanism is currently supported but will soon be obsolete.  It will be replaced by a completely translation manager-based solution in a future release of OLIT.  New applications developers should not use this functionality in this release or in subsequent releases of OLIT. 

In particular, developers should avoid using the following functions, which will soon be obsolete:

 OlClassSearchIEDB()
OlClassSearchTextDB()
OlCreateInputEventDB()
OlLookupInputEvent()
OlWidgetSearchIEDB()
OlWidgetSearchTextDB()
OlGrabVirtualKey()
OlUngrabVirtualKey()
OlConvertVirtualTranslation()
OlAction()
OlAssociateWidget()
OlUnassociateWidget()

3.0.1 FUNCTIONS

TextEdit Fuctions

A new function, OlTextEditMoveDisplayPosition, has been added.  This function enables you to move the display position in a TextEdit widget. It eliminates the screen flicker which sometimes occurs when you use XtSetValues to move the display position. 

WIDGETS

The Text widget is obsolete and is no longer supported. 

I18N INTERNATIONAL-IZATION

The OLIT 3.0.1 toolkit provides partial support for Level 3 Internationalization (I18N).  It currently implements all OPEN LOOK presentation text as widget resources.  See the following section for a list of the new resources.  Applications can override the default (English) labels and mnemonics of OLIT with 8-bit text in order to implement foreign language user interfaces. The OLIT 3.0.1 toolkit does not internationalize error and warning messages or provide locale announcement mechanisms; a future release of OLIT will support these features. 

3.0.1 RESOURCES

Application Resources

A resource, XtNmouseless, has been added to enable you to disable mouseless operation.  XtNmouseless defaults to TRUE.  When XtNmouseless is set to FALSE, the default widget does not get highlighted with the red input focus color and widget traversal is disabled for all objects except text input widgets.  Refer to textedit(3W) for more information on the behavior of input focus functions when XtNmouseless is set to FALSE. 

A new resource, XtNolDefaultFont, has been added to set the OLIT default font. It specifies the OPEN LOOK resolution-independent default font for a widget’s XtNfont resource. 

PopupWindowShell Resources

The following new resources have been added to allow you to specify labels and mnemonics for the automatically created buttons associated with the "Apply", "Reset", "Reset to Factory" and "Set Defaults" callback lists:

 XtNmenuTitle
XtNapplyLabel
XtNsetDefaultsLabel
XtNresetLabel
XtNresetFactoryLabel
XtNapplyMnemonic
XtNsetDefaultsMnemonic
XtNresetMnemonic
XtNresetFactoryMnemonic

TextEdit Resources

The following new resources are supported to allow you to specify labels and mnemonics for the automatically created buttons in the Edit menu and the title of the menu itself:

 XtNmenuTitle
XtNundoLabel
XtNcutLabel
XtNpasteLabel
XtNdeleteLabel
XtNundoMnemonic
XtNcutMnemonic
XtNcopyMnemonic
XtNpasteMnemonic
XtNdeleteMnemonic

Scrollbar Resources

The following new resources are supported to allow you to specify labels and mnemonics for the automatically created buttons in the Scrollbar menu and the title of the menu itself:

 XtNmenuTitle
XtNhereToTopLabel
XtNtopToHereLabel
XtNhereToLeftLabel
XtNleftToHereLabel
XtNpreviousLabelI
XtNhereToTopMnemonic
XtNtopToHereMnemonic
XtNhereToLeftMnemonic
XtNleftToHereMnemonic
XtNpreviousMnemonic

OBSOLETE BITMAP FILES

The following bitmap files are obsolete and are not included in the OLIT 3.0.1 release:

 bitmaps/a10pinin
bitmaps/a10pinout
bitmaps/a10pinout_d
bitmaps/a12pinin
bitmaps/a12pinout
bitmaps/a12pinout_d
bitmaps/a14pinin
bitmaps/a14pinout
bitmaps/a14pinout_d
bitmaps/a19pinin
bitmaps/a19pinout
bitmaps/a19pinout_d
bitmaps/b10pinin
bitmaps/b10pinout
bitmaps/b12pinin
bitmaps/b12pinout
bitmaps/b12pinout_d
bitmaps/c10pinin
bitmaps/c10pinout
bitmaps/c12pinin
bitmaps/c12pinout
bitmaps/c12pinout_d
bitmaps/clouds
bitmaps/cores
bitmaps/d10pinin
bitmaps/d10pinout
bitmaps/d12pinin
bitmaps/d12pinout
bitmaps/d12pinout_d
bitmaps/e10pinin
bitmaps/e10pinout
bitmaps/e12pinin
bitmaps/e12pinout
bitmaps/e12pinout_d
bitmaps/f10pinin
bitmaps/f10pinout
bitmaps/f12pinin
bitmaps/f12pinout
bitmaps/f12pinout_d
bitmaps/g10pinin
bitmaps/g10pinout
bitmaps/g12pinin
bitmaps/g12pinout
bitmaps/g12pinout_d
bitmaps/grune
bitmaps/h10pinin
bitmaps/h10pinout
bitmaps/h12pinin
bitmaps/h12pinout
bitmaps/h12pinout_d
bitmaps/i10pinin
bitmaps/i10pinout
bitmaps/i12pinin
bitmaps/i12pinout
bitmaps/j10pinin
bitmaps/j10pinout
bitmaps/j12pinin
bitmaps/j12pinout
bitmaps/k10pinin
bitmaps/k10pinout
bitmaps/k12pinin
bitmaps/k12pinout
bitmaps/loops
bitmaps/nights
bitmaps/openlook
bitmaps/skyscene
bitmaps/spin
bitmaps/stones
bitmaps/yuck
 

Version 3.0.1  —  Last change: June 92