Basic Configuration
Gmake is a vastly more flexible and portable version of the
make utility.
- makefile.tmpl
- This is the file that specifies the variables for the makefile.
Mostly, these variables specify the directories in which the
relevant libraries are found.
This is read indirectly by the makefiles in the
sub-directories that make provide access to the
different widget sets. So you should be able to specify
all the options here for all parts of the distribution.
Installation Configurable Parameters
WIDGET_SRC_DIR |
location of the Widgets directory which contains the
basic added widget distributions such as Xbae, Plot,
HTML, etc.
|
XPM_LIB |
directory containing the libXpm.so
or libXpm.a. This is used in -L$(XPM_LIB)
If Xpm is installed on your system
in the usual place (somewhere in the X11 include files),
you do not have to provide a value for this variable.
|
XPM_HDR |
directory containing the header source files for
the Xpm image library. If Xpm is installed on your system
in the usual place (somewhere in the X11 include files),
you do not have to provide a value for this variable. |
GIF_LIB |
some special functions are needed to make reading image files
more homogeneous. We provide code modified from the
xpaint distribution to perform these reads.
This variable specifies the directory containg the compiled
library.
|
GIF_HDR |
name of the directory containg the source code and header files
for the Gif library supplied with this distribution. |
X_SRC |
some of the S Xlib utilities (dangerously) rely on
the internals of the Xt library. Specifically, these routines
handle the variable arguments passed to XtVaSetValues
to gain efficiency since most of the control of the widgets
is available only throught this mechanism.
For the code to compile, a few of the files in the X source
distribution tree (in the Xlib and Xt branches) are needed.
The necessary files are provided with this distribution but
are not guaranteed to work correctly with all versions of
X. This reliance on internal code may be removed in the future.
|
EXTRA_CFLAGS |
this allows you to easily specify additional parameters
to be used when compiling C source files. These are appended to
the CFLAGS variable. Add any Defines
or compiler options here.
|
Installation & Targets
Tables and Named Vectors
Several of the functions in the SXLib library
use named vectors to specify different values.
Typically, a string corresponds to an integer and
the integers are passed directly to the X routine.
For this to work, the names must correspond to the
appropriate integer. Since these name-value pairs are
not completely consistent across all distributions of the
X libraries and different widget sets, we must create the
array dynamically.
The following executable functions do this.
| CursorInit |
maps the cursors identifiers to names |
The basic sequence of commands
for the generation of the chapter's S.so object is
make depend # make the dependencies file
make # makes the chapter
make widgetsets # makes the widget sets
Next, the S source code must be installed.
This is done via the command
make S
Alternatively, all of these steps
(creating the S.so and installing the S source code for each directory)
is can be done with a single call to make.
The relevant target is World so
make World.
is the simple command that installs everything.
Makefile Targets
| widgetsets |
makes the libraries associated with the standard
widget sets supported by the S-X library.
There are separate targets for each widget set.
These are Xbae, HTML, Xaw, Xaw3D, Motif, Xhdg, Plot.
|
depend |
makes the dependencies for the C level source files |
clean |
clean up after the compilation. This removes all .o and S.so
files. See the target tidy |
File Specific Information
- Convert.web
- Xbae must have a symbolic link that links the src directory
to the symbolic directory Xbae in src. That is the link is
circular.
This is explained in the Xbae installation procedures.
Miscellaneous Notes
-
class is no longer a field in
s_object *. It is now Class
to allow C++ code be compiled with #include
-
check as a macro<S.h> in the file.
-
-
check as a macro.
- The
s_object *check;
becomes
s_object* cur_thread->_S_options .Check ;
.
So avoid this.
- Don't declare
extern s_object *Frames, etc.
-
Todo for Installation
Change each of the makefiles in the WidgetSet directories
to handle the change of base location.
It would be nice to be able to include a file that doesn't exist
but have a rule to make it and have this work. Things don't seem to happen
this way. The case in point .Makefile.depenedcies in all the directories.
Duncan Temple Lang<duncan@stat.Berkeley.EDU>
Last modified: Tue Mar 4 07:57:06 PST 1997