# empgbldo

    EMPGBLDO(1)                                                        EMPGBLDO(1)

    NAME
           empgbldo - creates object files or C files for EMPRESS GUI applications

    SYNOPSIS
           empgbldo [-o object_file] [-f source_file] [-v version_number] [-m com-
           ment] [-d datadb] devdb application [application ...]

    DESCRIPTION
           Empgbldo  is a batch program which compiles Empress GUI applications to
           object files (.o files) or to C files (.c files).  After .o  files  are
           produced  the  user  must use empguicc to link the executable. The exe-
           cutable thus produced will be a runtime executable.

           Both script language and C API are supported for building the .c and/or
           .o files.

           The user must enter all paramters to empgbldo; there will be no prompt-
           ing for options.

           Two parameters are  required  to  empgbldo.  The  development  database
           (devdb) is the Empress database which stores all of the GUI objects for
           the application including the screen object definitions and script def-
           initions.   Once  the executable is built with empguicc the development
           database will not be needed for running the executable.

           The application list can contain one or more applications found in  the
           development database.

           -o object_file Specifies the output object file name. If no output file
                          is specified, the file empgout.o will be produced.

                          For QNX, because there is no utility to combine multiple
                          object  files,  empgbldo  will  produce  a  tar file and
                          append the extension .qnx to the output object file name
                          like  object_file.qnx.  empguicc recognizes this special
                          file extension.

           -f source_file Do not compile but rather  produce  multiple  .c  output
                          files  with the root source file name that is specified.
                          The files will be  named  MAIN_srcfile.c,  A_*_srcfile.c
                          and  M_*_srcfile.c,  where  srcfile  is  the source file
                          specified and * is a number.  If both -o and -f  options
                          are specified, both the .c and the .o files will be pro-
                          duced.

           -v version_number   Allows the specification of a version string to  be
                          included in the executable.

           -m  comment     Allows the specification of a comment to be included in
                          the executable.

           -d datadb Specifies the default data database name. If this not  speci-
                          fied  the  data database must either be specified within
                          the GUI scripts or will by default be assumed to be  the
                          same as the development database.

    FILES
           EMPRESS database files

    SEE ALSO
           empguicc(1), empgbldx(1), empgui(1)

    DIAGNOSTICS
           Error  diagnostics are printed if no development database is specified,
           or if it is not in Empress GUI format, or if it does  not  contain  the
           application(s)  specified. Error diagnostics are also printed unless at
           least one valid GUI application is given.

    HISTORY
           Written by Empress Software  Inc.   All  material  is  copyrighted  and
           licensed.  Use on non-licensed CPUs is prohibited.

    Empress Software                   Version 8                       EMPGBLDO(1)