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:

    The -help option causes sdtgilcvt to emit a synopsis of the sdtgilcvt command line and a list of options to the standard output. The -noproject option causes the default project settings to be used. No project file may be specified. The -project option converts GIL files in the context of a GIL project file, which must be supplied on the command line. The -silent option eliminates all progress messages. Only error messages are emitted, which are sent to stderr. 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:

    GIL project file. GIL interface file.

OUTPUT FILES
Following are the output files generated by the sdtgilcvt utility:

    BIL project file. 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:

    Successful completion. All files were converted. 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

    Convert all the files (project and interface) in the project file ``myproject.P'' to BIL format. Convert the modules module1 and module2 in the project ``myproject.P''. Convert the file ``module1.G'', ignoring any project that it may belong to.

SEE ALSO
dtbuilderaction(5), CDE Application Builder User's Guide.