### xmosaic-1.0 README file

                    README file for mosaic, version 1.0
                    Kirk Johnson
                    January 1991

    MANIFEST:

        README              this file
        Imakefile           for use with "imake"
        Makefile.DIST       for use with "make"
        mosaic.[ch]         non-X-related source code
        x11.[ch]            X-related source code
        mosaic.man          man page
        mosaic.scores       prototype high score file

    INSTALLATION NOTES:

    Mosaic can be built and installed "by hand", with "make", or with
    "imake". Brief instructions for each are provided below. If these
    instructions are somehow incorrect or deficient, please send me e-mail
    at the address shown below.

    - To build mosaic "by hand":

        (1) Compile the source file "mosaic.c", taking care to provide a
            define for the absolute path of the high score file (see
            "ABOUT THE HIGH SCORE FILE", below).

        (2) Compile the source file "x11.c".

        (3) Link the resulting object files with the X11 library to
            produce an executable.

        (4) Copy the executable and man page to whatever places are
            appropriate for your environment. Copy "mosaic.scores" to path
            you provided in step (1).

        (5) Use "chmod a+rwx ..." or "chmod 777 ..." to enable global
            read/write access for the copy of high scores file you made in
            step (4).

        On many systems, steps (1) through (3) might be accomplished with
        something like:

          cc -DScoreFile=\"/u/tuna/src/mosaic/mosaic.scores\" -c mosaic.c
          cc -c x11.c
          cc -o mosaic mosaic.o x11.o -lX11

        (You should replace "/u/tuna/src/mosaic/mosaic.scores" with the
        path you'll be using for the high score file in your system.)

    - To build mosaic with "make":

        (1) Copy the distribution makefile "Makefile.DIST" to "Makefile".

        (2) Edit the define for "ScoreFile" as appropriate for your local
            environment. (Replace "/u/tuna/src/mosaic/mosaic.scores" with
            the absolute path you want to use for the high score file; see
            "ABOUT THE HIGH SCORE FILE", below.)

        (3) Run "make all" to produce an executable.

        (4) Copy the executable and man page to whatever places are
            appropriate for your environment. Copy "mosaic.scores" to path
            you provided in step (1).

        (5) Use "chmod a+rwx ..." or "chmod 777 ..." to enable global
            read/write access for the copy of high scores file you made in
            step (4).

    - To build mosaic with "imake":

        (0) I'm not much of an imake wizard, so I don't guarantee that
            the following will work on your system. If you have trouble
            building mosaic according to these directions, you may want to
            resort to using "make" or building "by hand" according to the
            directions given above.

            On the other hand, if you _are_ an imake wizard and have
            reasonable suggestions about how I could improve these
            directions and/or the accompanying Imakefile, please send me
            e-mail at the address shown below.

        (1) Edit the provided "Imakefile"; replace the definition of
            SCOREDIR with the name of the directory you'd like the high
            score file to be installed in.

        (2) Build a Makefile with "xmkmf". (If your system has "imake" but
            not "xmkmf", you might try something like:

              imake -DUseInstalled -I/usr/lib/X11/config

            Read the "imake" man page or see your local imake wizard for
            more info.)

        (3) Run "make all" to produce an executable.

        (4) Run "make install" to install the executable and the high
            score file.

        (5) Run "make install.man" to install the man page.

    ABOUT THE HIGH SCORE FILE:

        Mosaic keeps a list of high scores in a simple text file; all
        users need to have read/write access to this file. You should take
        care not to put the high score file in a place some users will not
        have read/write access to.

        After installing mosaic, you may want to double check that other
        users can get at the high score file by having them play a game and
        ensuring that their scores appear in the high score file.

    AUTHOR:

        Mosaic was written by Kirk Johnson <tuna@athena.mit.edu>. It is
        based on Joshua Klayman's PC/MS-DOS shareware game of the same
        name. This version is a complete rewrite encompasing only the
        basic functionality of the original.

        Bug reports and suggestions are welcome.