sdtgilcvt(1)

NAME

sdtgilcvt − convert Devguide GIL files to BIL format

SYNOPSIS

sdtgilcvt [ options ] [ files... ]

DESCRIPTION

The sdtgilcvt utility converts Devguide GIL files to BIL files that can be read and manipulated by the CDE Application Builder. GIL files are supported primarily by Devguide, which is an OpenWindows/OPEN LOOK graphical user interface development tool. Sdtgilcvt can convert files written by any version of Devguide, up to version 3.0.1, which is the most recent version shipped. The GIL versions supported are GIL-1 to GIL-4.

The output format is BIL 1.0 (Builder Interface Language 1.0). This is the format supported by dtbuilder (the CDE Application Builder). A one-to-one mapping of GIL to BIL files is performed, converting GIL project to BIL project files, and GIL interface files to BIL module files. The BIL files are written as new files, with either .bip or .bil extensions, and the original GIL files are left unmodified.

The sdtgilcvt utility accepts multiple files on the command line, and each file supplied on the command line is converted from GIL to BIL format. However, only one (or no) GIL project file may be specified. If the sole argument is a GIL project file, the project and all interfaces referenced by the project are converted. If a project file and interface files are specified on the command line, all GIL interface files specified must belong to that project, and each of the interfaces will be converted. If neither -project nor -noproject is specified, the converter attempts to work in project mode by searching for an appropriate project file in the current directory.

If the desired behavior is to convert interface files independently of each other (i.e., with no project), the -noproject flag may be specifed. If -noproject is specified, each interface file specifed will be converted without looking at a project file. Conversely, if -project is specified a project file must be supplied.

OPTIONS

The following options are available:

−help The −help option causes sdtgilcvt to emit a synopsis of the sdtgilcvt command line and a list of options to the standard output.

−noproject The −noproject option causes the default project settings to be used. No project file may be specified.

−project <project-file>
The −project option converts GIL files in the context of a GIL project file, which must be supplied on the command line.

−silent The −silent option eliminates all progress messages. Only error messages are emitted, which are sent to stderr.

−verbose The −verbose option will cause sdtgilcvt to report detailed progress messages during the conversion process.

ENVIRONMENT VARIABLES

Sdtgilcvt does not recognize any specialized environment variables.

INPUT FILES

Following are the input files used by the sdtgilcvt utility:

file.P GIL project file.

file.G GIL interface file.

OUTPUT FILES

Following are the output files generated by the sdtgilcvt utility:

file.bip BIL project file.

file.bil BIL module file

EXTENDED DESCRIPTION

The sdtgilcvt utility is a translator that converts Devguide 3.0.1 and earlier GIL (.P and .G) files to BIL (.bip and .bil) files. The BIL files can be read and manipulated by the CDE Application Builder.

EXIT STATUS

The following exit values are returned:

0 Successful completion. All files were converted.

Nonzero
One or more files were not converted successfully.

CONSEQUENCES OF ERRORS

When an error occurs, sdtgilcvt sends a message to stderr and exits with a nonzero code. The source (GIL) files will be unmodified, and the output BIL file will not exist. If a BIL file existed prior to running sdtgilcvt, it will be given a .BAK extension, to show that it may be out of date.

EXAMPLES

sdtgilcvt myproject.P
Convert all the files (project and interface) in the project file “myproject.P” to BIL format.

sdtgilcvt myproject.P module1 module2
Convert the modules module1 and module2 in the project “myproject.P”.

sdtgilcvt -noproject module1.G
Convert the file “module1.G”, ignoring any project that it may belong to.

Museum

Related Articles