Imake Builder
Version 1.1
-----------------------------------------------------------------------------
Introduction
-----------------------------------------------------------------------------
Imake Builder (IB) is a Motif based tool to assist the programmer to
build and maintain portable Imakefiles. Multiple targets which may
consist of any combination of executables, libraries and directories
are supported. Comments and user customization are also supported.
Thanks to some great feedback, a number of changes have been made to
make IB's Imakefile more portable. These changes can be found in the
'Updates' document in the 'doc' directory.
Requirements:
X11R4/5
Motif 1.1/2
ANSI-C compiler
Currently running on:
SGI PI, Indigo, Onyx IRIX 4.05, 5.1, 5.2
Sun 4, Sparcstation
DEC Ultrix 4.3A
IBM RS/6000 AIX
Solbourne
HP
Dell SVR4
Linux 1.0 (386/DX33)
Where to get it:
Anonymous FTP: ftp.x.org:/contrib/ib-1.1.tar.Z (~104K)
(export.lcs.mit.edu)
E-mail: jdyvig@photon.com
-----------------------------------------------------------------------------
Important!
-----------------------------------------------------------------------------
Although IB-1.1 is compatible with Imakefiles generated by previous
versions of IB, a different bootstrap command is used. If you have
a '.ib_config' file created by a previous version, you may run into problems
compiling Motif programs. Delete this file and the proper bootstrap will
be used. This file may be found in the same directory as your Imakefile,
or in your home directory.
-----------------------------------------------------------------------------
Installation Procedure
-----------------------------------------------------------------------------
Installation of ImakeBuilder (IB) should be fairly simple on most Unix
systems. An automated build script has been provided to facilitate
this procedure. When compiling is complete, the system will ask the
user to register. Completing this form is important for future updates
of the code and for update notification. If the automated build does
not work properly, follow the instructions for manual compilation and
send the modifications made back to the author (jdyvig@photon.com).
For those who do not have color X-terms, you can set the following
in your .Xdefaults file:
IB*foreground: black
IB*background: white
IB's resource file 'IB' is located in the src directory. Some X-terms
handle the default color scheme this modification.
Automated Build:
% Build_IB
Manual Compilation:
Create RegForm tool...
% cd regform-1.0/src
% imake -DBuildMotif -DUseInstalledMotif -DUseInstalled \
-I/usr/lib/X11/config
% make
% mv regform ../../bin
% make clean
Create ImakeBuilder tool...
% cd ../../src
% imake -DBuildMotif -DUseInstalledMotif -DUseInstalled \
-I/usr/lib/X11/config
% make install
% make clean
% cd ..
Test Installation...
% cd bin
% ./ib
- First time only, fill in registration form and hit send
- Type in a target name and hit return
- Modify the target panel accordingly
- Select OK on the target panel to apply changes
- Choose "Create Imakefile" from the "Build" menu
- Choose "make Makefile" from the "Build" menu
- Choose "make Depend" from the "Build" menu
- Quit from the system menu
% make
-----------------------------------------------------------------------------
Installation Problems
-----------------------------------------------------------------------------
main.c: Incompatible pointer type assignment (Cardinal *)
This is valid for X11R4. For R5, take out the explicit typecast.
For most compilers this is just a warning so disregard the message.
Motif functions are undefined
The bootstrap used for creating the Makefile from the Imakefile
did not manage to include the Motif specific information.
Delete the #ifdef and #endif CPP directives around the line
XMLIB = -lXm. This will force the system to use -lXm on the
compile line.
Still doesn't work
You have a local installation of Motif and need to
specify where the include files and libraries are located.
Send me e-mail for more help and ask your systems
administrator to update the IMAKE config files.
My colors are screwed up!
Check out the second paragraph of the installation procedure
above.
I can't stand the registration/comments form!
The registration form comes up every time IB is invoked.
RegForm has tried to write to your home directory (assuming you
have one) and has failed every time. IB reads the file ~/.regform
to make sure the latest version has been registered, otherwise
it brings up the RegForm application or spits out a single line
warning. If this is irritating, recompile IB with the following
added to the CCOPTIONS line:
-DNOREGFORM
This bypasses the check for registration. By the way, regform
is not needed for IB to function properly so it can be deleted
from the system once you have registered. However, regform does
offer a convenient way to send comments and bugs back to the
author.
