GMF(1)

NAME

gmf − generate C and Motif source code for user interface elements described in a GIL file

SYNOPSIS

gmf [ options ] [ filename ]

DESCRIPTION

gmf reads a Graphical Interface Language (GIL) file created by OpenWindows Developer’s Guide, a user interface design editor. As it reads, gmf generates C and Motif source code for the OpenWindows user interface elements. Note that the end result will not closely resemble the interface built with Devguide. Devguide produces OPEN LOOK compliant interfaces, which differ in several ways from an equivalent Motif interface. Several objects exist in OPEN LOOK that do not exist in Motif. Also, many OPEN LOOK objects require two or more Motif widgets two achieve the same result. Additionaly, Motif widgets sizes and shapes differ.

Note that GIL files all end with a .G extension. gmf allows you to specify the filename with or without the extension: both filename.G and filename are acceptable names to specify filename.G to gmf.

OPTIONS

−s [−silent]
Sets gmf so it works silently, producing no messages while generating source code.

−v [−verbose]
Sets gmf so it is verbose, producing a message each time it generates source code for a user interface element.

−a [−ansi]
Sets gmf so it writes ANSI C (gmf defaults to -a). gmf will write the proper function prototypes for all functions. The resulting code will work with most ANSI C compilers.

−k [−kandr]
Sets gmf so it writes K&R C. gmf will write straight K&R C code, no function prototypes will be generated.

−n [−nomerge]
Prohibits gmf from merging existing and new _stubs.c files.

−p [−project] myproj
Sets gmf so it will generate code for project myproj

−m [−main]
Sets gmf so that it only generates source code for main() and any common callback functions in the project.c file. Only works with the -p option present.

−d [−domain] mydomainname
Sets gmf so it will use mydomainname when generating dgettext string wrappers. This overrides the default domain name of filename_labels.

−r [−resources]
Sets gmf so that it creates a resource file (the .resource file).

−? [−help]
Print out a help message explaining all gmf options.

FILES

filename_ui.c
The primary source code file, containing initialization and creation functions for user interface elements.

filename_ui.h
Contains declarations and C externs.

filename_stubs.c
Contains callback function templates for the element handlers specified in the user interface.

project.c
If gmf is generating code for a project, this file will contain the main() plus any callback functions that are common across interfaces.

project.h
If gmf is generating code for a project. This file will contain declarations for any callback functions that are common across interfaces.

filename.resources
If gmf is generating resources for the interface.

DIAGNOSTICS

gmf: reading interface.G
gmf is reading the GIL file.

gmf: writing interface_ui.c
gmf is generating the _ui.c source code file.

gmf: writing interface_ui.h
gmf is generating the _ui.h source code file.

gmf: writing interface_stubs.c
gmf is generating the _stubs.c source code file.

gmf: writing project.c
gmf is generating the project.c source code file.

gmf: writing project.h
gmf is generating the project.h source code file.

gmf: writing Makefile
gmf is generating a Makefile for the generated interface source code.

gmf: skipping Makefile
gmf detects an existing Makefile in the current directory and so is not generating a new Makefile.

gmf: file FILE: object OBJECT: attribute ATTRIBUTE: currently not implemented
gmf (or Motif) does not support this attribute.

gmf: object NAME: attribute ATTRIBUTE: cannot find string
gmf can’t find a string it expects to describe an attribute of a user interface element described in the GIL file.

gmf: object NAME: attribute ATTRIBUTE: cannot find integer
gmf can’t find an integer it expects to describe an attribute of a user interface element described in the GIL file.

gmf: object NAME: attribute ATTRIBUTE: cannot find boolean
gmf can’t find a Boolean setting it expects to describe an attribute of a user interface element described in the GIL file.

gmf: object NAME: attribute ATTRIBUTE: cannot find keyword
gmf can’t find a keyword it expects to describe an attribute of a user interface element described in the GIL file.

gmf: object NAME: attribute ATTRIBUTE: cannot find start of list
gmf can’t find the beginning of a list it expects to describe an attribute of a user interface element described in the GIL file.

gmf: object NAME: attribute ATTRIBUTE: cannot find start of name
gmf can’t find the beginning of a name it expects to describe an attribute of a user interface element described in the GIL file.

gmf: object NAME: attribute ATTRIBUTE: cannot find start of object
gmf doesn’t find an open parenthesis at the beginning of an object definition in the GIL file.

gmf: object NAME: attribute ATTRIBUTE: unexpected end-of-file
gmf encounters a truncated GIL file or a GIL file that doesn’t end with the proper file structure.

gmf: object NAME: attribute ATTRIBUTE: unknown file format
gmf encounters a GIL file missing the file header information that identifies it as a GIL file.

gmf: object NAME: attribute ATTRIBUTE: unknown value
gmf finds an attribute in a GIL file that it doesn’t recognize, or encounters an attribute value that is not appropriate for that attribute.

gmf: object NAME: attribute ATTRIBUTE: unknown object
gmf encounters an element that specifies an owner that doesn’t exist.

gmf: object NAME: attribute ATTRIBUTE: not a valid C identifier
gmf encounters an object name that is an illegal identifier in C.

gmf: object NAME: attribute ATTRIBUTE: WARNING, not a C identifier, ignored
gmf encounters a special handler in quotes and ignores it.

BUGS

None

SunOS — Last change: 17 September 1993

Museum