egnomebuild - Build an Eiffel project using egnome

egnomebuild [-verbose] root-class

egnomebuild uses SmartEiffel to compile a system that depends on the egnome class library.

The build, if successful, produces an executable called root-class.

-verbose

Show what egnomebuild itself is doing. (You may also want to specify -verbose in the variable SE_OPTS.)

To customise the build for your personal preferences, you may set certain variables in $HOME/.egnomebuild.rc. To customise for a particular project, you can use ./.egnomebuild.rc; if this exists it is used instead of $HOME/.egnomebuild.rc.

.egnomebuild.rc must be Bourne shell script with execute permissions set for the current user. If you assign to variables strings that contain white space, remember to enclose the whole string in quotes.

.egnomebuild.rc may set the following variables, which will override the default settings:

COMPILE

The command to use to compile the project; the default is 'se-compile'.

DEBUG

The flags to be given to the C compiler to control the inclusion of debugging aids in the object code; the default is '-g'.

OPTIMISE

The flags to be given to the C compiler to control optimisation; the default is '-O'.

SE_OPTS

The flags to be given to the SmartEiffel compiler; the default is '-no_strip -no_style_warning -case_insensitive'.

.egnomebuild.rc may also set the following variables, which will be prepended to the default options (therefore do not repeat the default options):

CECIL

Additional cecil files to be included. The default is '-cecil ${EGNOME}/C/se/cecil.se)

INCFLAGS

Compiler options to specify additional directories to search for include files. The default is '-I. `gnome-config --cflags glib gnome gnomeui gnorba gtk` -I. -I${EGTK}/C/se `gtk-config --cflags`'.

EXTERNAL

Other *.c and *.o files to include in the compilation. By default this variable contains "${EGTK}/C/se/eif_gtk_se.c ${EGTK}/C/se/eif_gtk.a".

LIBS

Compiler options to specify additional directories to search for libraries and libraries to include. The default is '${EGNOME}/C/se/eif_gnome.a `gnome-config --libs gnome gnomeui gnorba gtk`'

The whole command to be run is

$COMPILE $SE_OPTS $CECIL ${root_class}.e -o ${root_class} $DEBUG $OPTIMISE $INCFLAGS $EXTERNAL $LIBS

This command is obsolete because the need for it is now obviated by the availability of Ace files in SmartEiffel. In general an Ace file should be used to define an Eiffel system.

$HOME/.egnomebuild.rc

Settings for all builds by the user.

./.egnomebuild.rc

Settings for the project in the current directory. This overrides any settings in $HOME/.egnomebuild.rc.

SmartEiffel documentation for compile.

egnomebuild and this manpage were written by Oliver Elphick <olly@lfix.co.uk>