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 8.62                 Empress Software Inc.                 EMPGBLDO(1)