Files Provided with GXV

A

The Devguide software includes a set of files useful to Devguide and GXV users. These files are installed, along with Devguide and the code generators, on your workstation or server. You'll find the files in separate subdirectories in Devguide's home directory.

bin Subdirectory

The $GUIDEHOME/bin subdirectory contains the executable files for Devguide, GXV, GXV++, and gmomerge (as well as for GOLIT).

demo Subdirectory

The $GUIDEHOME/demo subdirectory has an xview subdirectory, that contains three files:

• rasview - A sample program to display images from raster files
• tree - A fractal tree drawing program
• psdraw - A PostScript drawing program that uses -lxvps

The $GUIDEHOME/demo/gnt subdirectory contains the following subdirectories:

• doc - Documentation in PostScript format
• man - gnt man page

include Subdirectory

The $GUIDEHOME/include subdirectory contains header files that can be included in the C source code for a window-based program using GXV. These files offer different useful components of Devguide's own interface for programmers to use in their own programs. They are:

• gcc.h - Color chooser used to select colors for UI elements
• gcm.h - Color manager used to keep track of colors set for different UI elements
• gdd.h - Drag and drop controller used to display the text contents of icons dropped into a window
• gfm.h - File chooser header file utility routines
• gfm_ui.h - File chooser header file
• gio.h - Input/output routines used to read and write GIL files
• group.h - Header file for the XView group extension
• guide.h - Routines that define elements and functions
• gutil.h - Double-click support

These files are all supplied "as is" and are not supported.

lib Subdirectory

The $GUIDEHOME/lib subdirectory contains two libraries of C modules that you can link into other C programs. The libguide.a library contains routines that are independent of the window system and the libguidexv.a library contains routines that depend on the XView toolkit. The modules in these libraries correspond to the components offered in the include subdirectory.

libgolit.a is the runtime library for GOLIT that provides facilities for you to create user interfaces described by GOLIT-generated C code.

In addition, lib contains the XView.config, and OLIT.config files. These files are used to configure the Connections Manager window for the three toolkits. They list the events, actions, and targets that are permitted in the XView, and OLIT toolkits, respectively, for each possible source object.

lib also contains a help subdirectory that includes help files for Devguide, a locale subdirectory to be used for localization, and a templates subdirectory described below.

lib/templates Subdirectory

The templates subdirectory contains sample GIL files. An OPEN LOOK property window and OPEN LOOK application window created in properties.G and sample.G can be used as templates in your application to get you started. The sample application window contains File, View, and Edit menu buttons. controls.G contains examples of UI elements you can create using Devguide.

man Subdirectory

The $GUIDEHOME/ man subdirectory contains man pages for Devguide's accompanying XView code generator, GXV. To see them when you use the man command, you can append $GUIDEHOME/man to the MANPATH variable to look in this directory when you use the man command. You can also use man -M path to view man pages that are not in the standard path. The -M option overrides MANPATH. For more information, see the man(1) man page.

src Subdirectory

The $GUIDEHOME/src subdirectory contains source code for the libraries included in the lib subdirectory. This source code is supplied "as is" and is not supported. You can port the source to other platforms.

doc Subdirectory

The $GUIDEHOME/doc subdirectory contains miscellaneous documentation about Devguide. The GIL syntax file gil_syntax.doc and project syntax file project_syntax.doc can be found in this subdirectory.