;;;
;;; **********************************************************************
;;; This code was written as part of the CMU Common Lisp project at
;;; Carnegie Mellon University, and has been placed in the public domain.
;;; If you want to use this code or any part of CMU Common Lisp, please contact
;;; Scott Fahlman or slisp-group@cs.cmu.edu.
;;;
;;; $Header: system-notes.txt,v 1.1 91/06/10 16:23:28 chiles Exp $
;;;
;;; **********************************************************************
;;;
;;; This file contains notes on maintaining CMU Common Lisp, specifically
;;; how to use utility files for various things.
;;;

Whole system
   Updating from RCS
      cd /afs/cs/project/clisp/new-compiler/@sys/alpha
      $tools/rcsupdate -q
   Compiling Everything (except PCL)
      $tools/compile-all
   Building kernel.core
      lisp -noinit
      (setf (search-list "target:")
	    '("/afs/cs/project/clisp/new-compiler/@sys/alpha/"))
      (load "target:compiler/generic/genesis")
      (load "target:tools/worldbuild.lisp")
   Building lisp.core
      $tools/mk-lisp alpha :small


Releases
   distribution done via AFS
   Necessary order
      DEFAULT
         cd /afs/cs/misc/cmucl/@sys/omega
	 mv ../beta/bin/lisp bin/
	 mv ../beta/lib/lisp.core lib/
         cd /afs/cs/misc/cmucl/all_mach/omega
	 mv ../beta/doc/release.doc doc/
      BETA
         cd /afs/cs/misc/cmucl/@sys/beta
	 mv ../alpha/bin/lisp bin/
	 mv ../alpha/lib/lisp.core lib/
         cd /afs/cs/misc/cmucl/all_mach/beta
	 mv ../alpha/doc/release.doc doc/
      ALPHA
         $tools/inst-lisp		; from same dir mk-lisp was done in
	 post on clisp bboard


Adding files to Hemlock:
   Update compilation.order
   Update hemlock.upd
   Update tools/hemcom.lisp
   Update tools/hemload.lisp


CLX
   ftp ucbarpa.berkeley.edu
   cd pub
   lcd <where-you-want-it>
   binary
   get clx.tar.Z


PCL
   Fetching
      ftp
         cd to pcl dir in AFS
         ftp arisia.xerox.com
         anonymous
         chiles@cmu (or anything I want to type)
         cd /pcl    (or /pub/pcl)
	 prompt     (to turn off interactive mode)
	 mget *
      notes
         ignore
            old notes files   (keep notes.txt)
            -low for anyone but CMU and Lucid (or whatever we might build for)
            7debug.lisp
            -patches for any Lisp but those we build for (CMU)
   Comparing sources
      always take our first line for Hemlock package mods.
      files
         combin-test
	    Load to test method combination.
	 compat
	    PCL --> CLOS compatibility  (now empty)
	 defsys
	    Loading and compiling.  Gregor hasn't picked up our latest mods.
	 fin
	    Funcallable instance.  crawls around stack to change currently
	    running methods, or something.
	 walk
	    Code massager.  Just take CMU shit because Grego never picked up
	    our mods.
	pkg
	    Take CMU shadows.
   Building PCL
      lisp -noinit
      (rename-package (find-package "PCL") :no-pcl-here)
      (setf (search-list "target:")
	    '("/afs/cs/project/clisp/new-compiler/@sys/alpha/"))
      (setf (search-list "pcl:") '("target:pcl/"))
      (load "target:tools/pclcom")
