       How to rollover the KSOS Kernel to a new trunk revision.


 1. Do a "(cd RCS; rlog -L -h *)" command to make sure that no files to
    be checked in have any locks already set.

 2. Build the Kernel in a directory with the revisions of the files to
    be checked in.

 3. Edit BUILD.mod so the EPLWHAT string contains the new trunk
    revision and the typeLine('Built ...') statement has the current
    date and time hardcoded in.  Do not lock the file or check it in.
    Delete any backup files that are created.

 4. Do another "make" to update Kernel.out.

 5. Rename Kernel.out to any name that begins with "R" (e.g., R.kernel).

 6. Do a "make clean".

 7. Write the log message for this rollover into a file whose name
    begins with "R".

 8. Delete or rename any other files that are not to be checked in so
    their names begin with "R".  All files that begin with a letter of
    the alphabet (except "R") will be checked in.

 9. Type "rcs -l0.# [A-QS-z]*", where "0.#" is the number of the
    *latest* trunk revision.  There should be no error messages.

10. Type "ci -f0.# -sStab [A-QS-z]* < R.log", where "0.#" is the
    number of the *new* trunk revision and R.log is the name of the
    file containing the log message for this rollover.  There should
    be no error messages.

11. List the contents of the directory.  The only files remaining
    should be those beginning with "R".

12. Check out the Makefile and do a "make".

13. Do a byte-by-byte comparison of the new Kernel.out with the saved
    Kernel in the "R" file (e.g., "cmp Kernel.out R.kernel").  They
    should be identical.

14. Delete the saved Kernel and the file containing the log message
    for this rollover.

15. Using these instructions as a guideline, roll over the kernel
    interface library, the nksr library, the trusted library, stc, the
    initial process, PBB, SIP, SSD, and ACPop so they have the same
    trunk revision number as the kernel.

16. If more Kernel work is to be done, edit BUILD.mod so the EPLWHAT
    string identifies the type of work in progress and check it in as
    revision 0.#.1 (0.# is the new trunk revision number).
