 -*- Mode: Text;  -*-
 File: README
 Author: Heinz Schmidt (hws@csis.dit.csiro.AU)
 Copyright (C) CSIRO Division of Information Technology, 1992

 COPYRIGHT NOTICE: This code is provided "AS IS" WITHOUT ANY WARRANTY
 and is subject to the terms of the SATHER LIBRARY GENERAL PUBLIC
 LICENSE contained in the file: "sather/doc/license.txt" of the Sather
 distribution. The license is also available from ICSI, 1947 Center
 St., Suite 600, Berkeley CA 94704, USA.
*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* HISTORY:
* Created: Thu Feb 20 21:15:17 1992 (hws)
*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This directory contains elisp sources related to the Sather programming 
environment. The functions are documented in sather/doc/sather-emacs.txt.
Unlike the release 0.01, there is no more epoch-lisp directory. 
Everything's in here. Files prefixed "epoch" are related to Simon Kaplan's
public domain cs.uiuc.edu Epoch editor. 
Moreover we have precompiled all elisp files. The bytecompiled form
is portable more compact than the source and avoids the additional 
installation steps and problems where a working Emacs is installed but
the byte compiler tools are not.

bytecomp.patch       -- a patch to the virgin Emacs byte compiler to speed up
                        our code.

ep-minibuf.el        -- For novice Epoch users. Let's minibuffer follow main window.

ep-ksy-base.el       -- Basic mouse interface to epoch (for sky-mouse).
ep-scrtitl.el        -- For novice Epoch users. Names windows after buffer or command.
lang-tools.el        -- Template editing, source browsing, doc primitives.
                        The language independent functions encapsulated.
ll1-sdts.el          -- LL(1) syntax directed translation schemes fpr Emacs.
mini-cl.el           -- Part of Epoch distribution, we use it somewhere and
                        want to able to run the code under non-Epoch Emacs.
                        Make independent later.
mulindt.sa           -- Sather example for multi line indentation testing.
poor-mouse.el        -- Basic mouse interface when there's no mouse (for sky-mouse).
                        Useful under Maclayers or other poor modem emacs.
                        Invoke language related commands from keyboard only.
sac.el                     -- Translater from Pseudo-Sather C declarations to C.
                        Allows to wrap x.h x.c x.macros around well-tested
                        C packages that you want to use with Sather.
                        Cf. sather/doc/sac.txt.
sac-it.el            -- Shell for running sac above from makefile when
                        cs MYCLASS depends on C interface. Let make find
                        what needs to be regenerated.
sather.el            -- top level sather mode, lets Emacs or Epoch know
                        about Sather.
scrollm.el           -- Make mouse a scroll device to flip line to top or drag
                        line someplace else.
sdb-mode.el          -- Commands for running sdb under Emacs, a gdb minor mode.
sky-mouse.el         -- The programmers mouse.
thing.el             -- Tells Emacs commands, particularly mouse commands,
                        what are interesting "things" in the language at hand.
x-sky-bas.el         -- Basic mouse interface to Emacs x-mouse (for sky-mouse).
