This file contains instructions to compile and install the programs in
this distribution. To make these programs:

(1) Edit Config.local and choose the compilation options, install
    destination directory and clock drivers, if needed.

(2) Type "make makefiles".  This runs a shell script that pokes your
    hardware and software configuration and builds the configuration
    file and Makefiles in the various directories.  If the script fails,
    it will give you a list of machines it knows about.  You can override
    the automatic choice by cd to the ../machines directory and typing
    "make makefiles OS=<machine>", where <machine> is one of the file
    names in the ../machine directory.

    The shell script will attempt to find the gcc compiler and, if
    found, will use it instead of the cc compiler.  You can override
    this automatic choice by cd to the ../machines directory and typing
    "make makefiles CC=<compiler>", where <compiler> is one of the file
    names in the ../compilers directory. This can be combined with
    the OS argument above.

(3) Type "make" to compile everything of general interest. Expect few or
    no warnings using cc and a moderate level on warnings using gcc.

(4) Assuming you have write permission on the install destination directory,
    type "make install" to put the binaries in the system directory
    you mentioned in Config.local.  At the time of writing this includes
    the programs xntpd (the daemon), xntpdc (an xntpd-dependent query
    program), ntpq (a standard query program), ntpdate (an rdate
    replacement for boot time date setting and sloppy time keeping)
    and xntpres (a program which provides name resolver support for
    some xntpd configurations).

(5) You are now ready to configure the daemon and start it.  At this
    point it might be useful to format and print the file doc/notes.me
    and read a little bit.  The sections on configuration and on the
    tickadj program will be immediately useful.

Additional "make" target you might find useful are:

clean		cleans out object files, programs and temporary files

distclean	does the work of clean, then ambushes old patch
		files, tar files and Makefiles

depend		possible maker of hazardous waste

All bug reports gratefully received.

The distribution has been compiled and run on at least the following
machines, operating systems and compilers:

  ConvexOS 10.1
  SunOS 4.1.{2,3} using both cc and gcc
  SunOS 5.2/Solaris 2.2 using both cc and gcc
  IRIX System V.3 (IRIX4)
  AIX 3.2
  ULTRIX 4.2a using both cc and gcc
  DECOSF/1 using both cc and gcc

William L. Jones jones@chpc.utexas.edu
  
Dennis dennis@gw.ccie.utoronto.ca
Lars Mathiesen (University of Copenhagen) <thorinn@diku.dk>
David Mills <mills@udel.edu>
