GTK+ for OpenVMS requires the following software. (Other configurations have not been tested.)

Expanding and Installing GTK+ for OpenVMS

Perform the following steps to expand and install GTK+ for OpenVMS.

Building GTK+ for OpenVMS

This section explains how to build GTK+ for OpenVMS.

During a build of GTK+ for OpenVMS, the following directories are built:

• glib
• gmodule
• gthread
• tests (optional)
• gtk
• gdk
• gtk

Each directory contains a VMS_BUILD.COM that is used to build the contents of that directory, plus the contents of its subdirectories.

Most tests can be built by invoking VMS_BUILD.COM in the appropriate directory and passing it the parameter test.

After the build has completed, four shareable images have been created:

• [GTK128.GLIB]LIBGLIB.EXE
• [GTK128.GLIB.GMODULE]LIBGMODULE.EXE
• [GTK128.GTK.GDK]LIBGDK.EXE
• [GTK128.GTK.GTK]LIBGTK.EXE

Your Application and GTK+ for OpenVMS

Consider the following when you build your application and link against the GTK+ shareable images.

• The code added to GTK+ for OpenVMS uses event flags 2 and 3 without allocating them. Your application must not use these event flags. This restriction will be lifted in GTK+ 1.3 by ensuring that any event flags used are allocated via LIB$GET_EF.
• GTK+ is compiled using /NAMES=AS_IS. This means that all of the entry points in the shareable images are case-sensitive, and you will have to compile your application the same way. If you want to change this, edit VMS_CC.COM (to remove NAMES=AS_IS) and all the xxx_create.opt files (to remove the CASE_SENSITIVE statements) and rebuilt GTK+.
• GTK+ is compiled using /NAMES=SHORTEN. This means that any long symbol names in the GTK code are shortened rather than truncated. Your application should also be compiled with this qualifier.
• GTK+ is compiled using /FLOAT=IEEE and /IEEE=DENORM. Your application must also be built with these qualifiers.
• When compiling code that uses GLib, include the following directories on your header file include path:
• [GTK128.GLIB]
• [GTK128.GLIB.GMODULE]
• When compiling code that uses GTK, include the following directories on your header file include path:
• [GTK128.GTK]
• [GTK128.GLIB]
• [GTK128.GLIB.GMODULE]
• There are four shareable images against which you need to link your application, as follows:
• [GTK128.GLIB]LIBGLIB.EXE
• [GTK128.GLIB.GMODULE]LIBGMODULE.EXE
• [GTK128.GTK.GDK]LIBGDK.EXE
• [GTK128.GTK.GTK]LIBGTK.EXE

POSIX and GNV Considerations

If you are building your application inside of POSIX or GNV, then GLib and GTK both need to be installed so that autoconf based applications can locate the installations. If you have built GLib and GTK on OpenVMS, then they are already installed and glib-config and gtk-config can be used as usual.

For example, if your GTK+ directory root is DKB300:[GTK128], you can configure an autoconf based application as follows:

configure \
  --with-glib --with-glib-prefix=/dkb300/gtk128/glib/ \
  --with-gtk --with-gtk-prefix=/dkb300/gtk128/gtk/ 

Following is a summary of the changes made to the GTK+ source files.

• [GTK128.GLIB]GMAIN.C
• Changed to use event flags as the wakeup mechanism

• [GTK128.GTK.GDK]GDKDND.C
• Use VMS_SETUP_WINDOW_NOTIFICATION macro when a window is created
• [GTK128.GTK.GDK]GDKEVENTS.C
• Add code to translate OpenVMS-specific MOTIF key bindings so they appear normal
• Use an event flag (VMS_EF_GTK_WINDOW_EVENT) for notification instead of ConnectionNumber
• [GTK128.GTK.GDK]GDKWINDOW.C
• Use VMS_SETUP_WINDOW_NOTIFICATION macro when a window is created
• [GTK128.GTK.GDK]GXID.C
• Change name of socket_fd (this file is not built)
• [GTK128.GTK.GTK]GTKDND.C
• Add stdlib.h so that abs is known
• [GTK128.GTK.GTK]GTKFILESEL.H
• Use macros to copy/compare struct st_ino fields
• Make a local inode definition inode[3]
• Perform case blind comparisons
• Change find_parent_dir_fullname so that it does not use chdir (cannot chdir up to /)
• [GTK128.GTK.GTK]GTKMAIN.C
• Translate HOME to UNIX equivalent and re-save
• Include unixlib.h
• [GTK128.GTK.GTK]TESTRGB.C
• ifdef out struct timezone declaration and make second arg in gettimeofday call NULL instead of tz

Compaq provides the following OpenVMS-specific build files in the GTK+ kit.