This note accompanies the file ultra.tar.gz; this is a uuencoded
gzipped tar file containing the Ultra-TeX package for emacs.  There
are about 11 files in the package, and once extraced the whole thing
takes up around 90k.

Brief description (a few more details are given below):

  1. Ultra-TeX mode is a mode for editing TeX files in emacs.  One of
  its primary features is that it does dynamic completion on TeX
  commands (i.e., completion without hitting TAB or any other key).  it
  is not immediately compatible with AUC-TeX, but some enterprising
  person could probably combine the two packages without too much
  difficulty.  To be honest, I don't know much about the features of
  AUC-TeX, other than the fact that it does some things that Ultra-TeX
  doesn't, and vice versa.

  2. Dynamic completion is provided through the file light.el; this
  provides for completion not just of TeX commands, but also of file
  names, buffer names, lisp functions, buffer contents, menu items in
  info, etc.  To me, this is the main selling point of the whole
  package. 

I didn't write this package, but I am distributing it.  You might want
to ask me questions first; if I can't answer them, I'll refer you to
the authors.  Also, this package is written for emacs 19; a version
for emacs 18 exists (pretty much) and is available upon request to
palmieri@math.mit.edu (although there may be a brief delay while I get
it organized).

John Palmieri
palmieri@math.mit.edu
http://www-math.mit.edu/~palmieri/





-------------------------------------------------------------------

The following documentation is excerpted from the .doc files in the
archive.  See those for more details.

Caveat: the doc files were written several years ago, and the packages
have since changed slightly (for example, ultex was changed to reflect
the change LaTeX209 --> LaTeX2e).  I have tried to make the
appropriate changes in the documentation, but I may not have caught
everything.


The Lightning Completions Package (light.el)
---------------------------------

Lightning completion is a minor mode, signified by "Light" on the mode
line.  When in lightning completion mode, completion occurs
automatically after each key is pressed.  Several keys control special
actions...

(description of keys omitted--see light.doc for details.)

Lightnification
---------------

The light.el package contains more than is necessary for Ultra TeX; it
can be used to provide "dynamic" style completion commands of all
kinds, and to make existing minibuffer-reading commands complete
dynamically.

Here is a typical use of lightning completion outside of Ultra
TeX.  For a lightnified version of find-file, use:

        (lightnify 'find-file-light 'find-file)
        (global-set-key "\C-xf" 'find-file-light)

(other examples in light.doc, lighthacks.el, bufcomp.el)


Ultra-TeX Mode (ultex.el, etc.)
--------------

Ultra TeX mode is a major mode for editing TeX documents.  Typing
C-h m while in Ultra-TeX-mode will display information on the
mode.

Completion of Control Sequences
-------------------------------

Typing a backslash (\) starts lightning completion of control
sequences.  The ultex-tree-file is the file of permanent control
sequences to complete on.  Also, when you find a TeX file, control
sequences defined in that file are added to the list of things to
complete on.

Greek Keyboards
---------------

Since there are many symbols which have TeX control sequence names, it
is undesirable to clutter up the completion list with these.  Instead,
several Greek Keyboards are provided in Ultra TeX mode.  The key `
acts as a "Greek shift" key.  For example, typing `g will insert
"\gamma" in the buffer, and typing `G will insert "\Gamma".

Fonts
-----

Typing ESC B will insert "\textbf{}" or "\mathbf{}" and leave point
just inside the group.  Similarly, ESC A,C,E,F,I,M,R,S,T,Z make
cAligraphic, smallCaps, Emphasis, sans-seriF, Italic, Math-italic,
Roman, Slant, Typewriter and uZer's-math (defined as \zz) fonts.

Smart Return Key
----------------

The RETURN key moves point forward by some appropriate amount.  Often
this means moving outside of a close bracket, or over a whole word.
To insert a newline, use ESC RET. LFD ends a paragraph when that makes
sense, and checks the paragraph to see if parentheses, etc. are properly
matched.

Smart Dollar Signs
------------------

$ makes a $ pair.  $$ makes displayed equation.  Repeated $ cycles
among the following (here, @=point)

$$
@
$$

\[
@
\]

\begin{equation}\label{@}

\end{equation}

etc.

Written by Mark Haiman and Nick Reingold.
Comments, suggestions, etc. should be sent to 
mhaiman@macaulay.ucsd.edu

(this documentation edited slightly by John Palmieri, 16 October 1995,
palmieri@math.mit.edu)