home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-2 / X11 / server / MouseX / X11R5-source.patch.README < prev    next >
Encoding:
Text File  |  1996-11-09  |  5.5 KB  |  103 lines

  1.             README for X11R5 MIT source patches for NeXT 3.0
  2.  
  3. The file X11R5-source.patch.tar.Z contains a number of patch files, divided according to the portion of the mit code that they patch.  
  4.  
  5. CAVEAT:  COMPILING THE X SOURCE TREE IS NOT A PROJECT FOR THOSE WHO DO NOT HAVE EXPERIENCE COMPILING C CODE THE OLD-FASHIONED WAY AND USING MAKEFILES.  GET INVOLVED IN THIS AT YOUR OWN RISK :-)
  6.  
  7. DISCLAIMER:  I HAVE NOT TESTED THIS SET OF PATCHES ON A VIRGIN COPY OF THE MIT SOURCE--I JUST DONT HAVE THE TIME.  I CANNOT GUARANTEE THAT THERE ARE NO PROBLEMS WITH IT.  I HAVE ALSO NOT TESTED THIS COMPILE USING THE NATIVE NEXT C COMPILER.  IF YOU ARE **SURE** THAT YOU HAVE FOUND A PROBLEM WITH THE NEXT PATCHES (I.E., MISSING FILES OR BAD PATCHES), PLEASE LET ME KNOW.
  8.  
  9. Instructions for applying patches to MIT source code:
  10.  
  11. 0)  Make sure you have the 'patch' program on your machine.  It is available on
  12.     many of the archives as "patch.Z".
  13.     
  14. 1)  Acquire a complete MIT R5 X source tree:
  15.  
  16.     a) ftp anonymously to export.lcs.mit.edu
  17.     b) Grab all the contents of pub/R5/mit-1, pub/R5/mit-2, and pub/R5/mit-3
  18.     c) Optionally, you may grab the contents of pub/R5/mit-4.  This is not
  19.        required, as this is mainly documentation.
  20.     d) Make sure you are in the directory in which you wish to have the top
  21.        level of the MIT source reside (/usr/local/src/X, for example).
  22.     e) For each set of mit-* files, do the following (for example, for mit-1):
  23.            cat mit-1* | uncompress | tar xvf -
  24.        You will need to do this separately for each set, i.e., for mit-1*,
  25.        mit-2*, and mit-3*.
  26.     f) remove all the mit-* files.  You will be left with a directory called
  27.        'mit', which is the top-level directory for all the MIT X code.  All the
  28.        code will be in that directory and in its many subdirectories.
  29.  
  30. 2)  Grab all 22 MIT 'fix' files from pub/fixes on the same archive.  You will
  31.     also need to grab PEXlib.tar.Z and untar it in the directory above the mit
  32.     dir.  It will create a large number of files inside the mit directory.
  33.     
  34.     All these patches must be run on the source code ****BEFORE**** you try to
  35.     run the patches for the NeXT!
  36.     
  37.     The top of each of the fix files explains how to apply the patch (i.e., 
  38.     where you should be directory-wise, and what arguments to use for patch).
  39.     
  40. 3)  Once you have patched the MIT code up to patch level 22, and untarred the
  41.     PEXlib code, you are set to apply the NeXT patches:
  42.     
  43.     a)  make sure you are in the directory immediately above the mit dir (for 
  44.         example, if you have located mit as /usr/local/src/mit,  you should be
  45.         in /usr/local/src).
  46.          
  47.     b)  for each of the NeXT patches, do 'patch -p0 < patchfile', where 
  48.         "patchfile" is the name of the patch you are doing.  The order in
  49.         which you do the patches does not matter, as long as you do them all.
  50.         
  51. Now you have a complete X11 R5 source tree, which you can use to compile all the X libraries, binaries, fonts, and the Xnext color or monochrome server.  To learn how to compile and install this whole mess, read the RELNOTES.TXT file in the mit directory, for a start.  **Please** do not send me mail about this--there is plenty of documentation along with the X code.  Remember--you can always grab this stuff pre-compiled from my archive on foxtrot.ccmrc.ucsb.edu instead of building it yourself!
  52.  
  53. IMPORTANT NOTES:
  54.  
  55. This distribution is currently configured to compile using the gcc 2.3.3 compiler, which is what I use for all my C compiling.
  56.  
  57. If you have installed the Gnu C compiler, gcc 2.3.3, on your machine, you should be able to build the entire distribution with almost no changes whatsoever.
  58.  
  59. If you are using the native NeXT 3.0 compiler, you may have to make some changes, but it should not be too hard.  See the notes about configuring, below.  I cannot help you with this, since I dont use it.  If you get horribly stuck, you can send me email, and I will help if I can.
  60.  
  61. Configuring:
  62.  
  63. There is a file called mit/config/site.def, which is a site-specific
  64. configuration file for building the X source.  There are three lines
  65. in there which are of importance--
  66.  
  67. #define BuildColorServer
  68.  
  69.     To build the 2-bit, monochrome (grey-scale) server, comment out this line.
  70.     To build the color server, remove the comments.
  71.     
  72.     If you wish to build BOTH servers, configure the entire source tree for
  73.     color first.  Then do the following after you have build and installed the
  74.     mono server:
  75.         a)  Comment out the above line as indicated.
  76.         b)  cd into mit/server and type the following:
  77.                 rm ddx/cfb/*.o
  78.                 rm ddx/next/*.o
  79.                 make Makefile
  80.                 make Makefiles
  81.                 make depend
  82.                 make
  83.         c)    a certain small amount of code will get recompiled, and a new Xnext
  84.             will be built--this one will be the monochrome version.  To build
  85.             the color server again, just uncomment the site.def line, and
  86.             repeat the above process.
  87.  
  88. #define HasGcc YES 
  89. #define HasGcc2 YES
  90.  
  91.     To build the source tree using the native C compiler, comment out these two
  92.     lines.  Otherwise, leave them as they are now.
  93.  
  94. Future Changes:
  95.  
  96. The code for the server (in mit/server) will be changing constantly as I continue to make modifications and improvements.  I will post incremental patches to the net as I see fit.  Once you have configured, compiled, and installed this thing, you can do a 'make clean' on it if you need to save space, but SAVE A COPY OF THE PATCHED SOURCE TREE so that you can recompile the server when improvements are made available as patches.
  97.  
  98. ---
  99. Douglas Scott
  100. Center for Computer Music Research and Composition
  101. University of California, Santa Barbara
  102. Internet: (NeXTMail ok)   <doug@foxtrot.ccmrc.ucsb.edu>
  103.