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