itools-R6.1 README

Table of Contents

• Introduction
• Before You Build
• Building the Distribution
• Installing the Distribution
• Miscellaneous

Introduction

The itools distribution contains imake, some related configuration programs, and a set of X11 configuration files. Instructions for building and installing the distribution may be found in Appendix B of the "boa book":

   Software Portability with imake (2nd edition)
   Paul DuBois
   O'Reilly & Associates, 1996
   ISBN 1-56592-055-4

   http://www.primate.wisc.edu/software/imake-book/
   ftp://ftp.primate.wisc.edu/software/imake-book/

Most of this distribution was derived directly from the distribution of the X Window System, Version 11, Release 6.1.

This distribution has been superceded by an R6.3-based itools distribution. However, to build that distribution, you must have an ANSI C compiler. If you don't have one, or you encounter other problems building the R6.3-based distribution, the R6.1-based distribution may be useful.

Before You Build

Before you build the distribution, there are a few things you should check.

Look in the config/misc directory to see if there are any notes for the type of system you're using. If there are, read them.

Take a look at config/cf/site.def and read the comments to see if there's anything you'd like to modify.

Take a look at config/extras/extras.tmpl and check the following:

All systems:

• If you're going to install imboot and you don't want to use /usr/local/lib/config as the imboot configuration root directory, change the value of CONFIGROOTDIR.
  

• Make sure the value of PERLPATH is correct for your system. This is needed for building Perl scripts. It can be the full pathname of either Perl 4 or Perl 5.
  
• If you want to use the sh version of imboot, the "#define UsePerlImboot" line should be commented out:
  

     /*#define UsePerlImboot YES*/
  

  If you want to use the Perl version of imboot, the line should be uncommented:
  

     #define UsePerlImboot YES
  

• If you want to use the sh version of xmkmf, the "#define UsePerlXmkmf" line should be commented out:
  

     /*#define UsePerlXmkmf YES*/
  

  If you want to use the Perl version of xmkmf, the line should be uncommented:
  

     #define UsePerlXmkmf YES
  

• If you have the Windows NT version of Perl, you can use the Perl script imdent and the Perl versions of imboot and xmkmf. Uncomment the "#define WinNTHasPerl" line:
  

     #define WinNTHasPerl YES
  

  If you don't have Perl, the line should be commented out:
  

     /*#define WinNTHasPerl YES*/
  

  In the latter case, you won't be able to use xmkmf, imboot, or imdent.
  

Building the Distribution

   % cp Makefile.sav Makefile

   % make World                  (or)
   % make World BOOTSTRAPCFLAGS="flags"

For Windows NT, the command for building the distribution is shown below, but before you run it, make sure you read config/misc/Win32.notes:

   nmake World.Win32 > world.log

Installing the Distribution

For UNIX, run this command (you may need to be root) to install everything built by the build step:

   % make install

   nmake install

You can also install individual targets. For example, if you want to install a program "prog", you can change into the directory in which the program is built, then run "make install.prog" under UNIX. Under NT, use "nmake install.prog.exe" or "nmake install.prog.bat", depending on whether prog is an executable binary or batch script.

Miscellaneous

Some of the differences between the itools distribution and the original X stuff from which it was derived:

• The config/misc directory contains notes for various systems that might be useful or of interest.
  
• The config/extras directory (containing imboot, msub, and imdent) is not part of X.
  
• The Perl version of xmkmf (in config/util) is not part of X.
  
• which (in config/util) is not part of X.
  
• Most of the original files were mode 444 (read only), the presumption being that you would just use them to build and install X, but not modify them. I'm presuming that you may very well want to mess around with anything that's here, consequently all the files are writable.
  
• Many of the Imakefiles and a few other files were changed from the originals in the X11R6.1 distribution. (You can usually tell that a file xxx was modified if a file xxx.orig is present.)