pmacs3/README

Pmacs version 0.1

Released June 27, 2007 by Erik Osheim <erik@osheim.org>

Pmacs is an Emacs-like editor written entirely in Python. It is designed to have
maximally correct and powerful support for syntax highlighting, to support
various methods of automatically indenting lines, and to be extensible in
python.

Pmacs is available to you under the GPL version 2.

While the general interface of pmacs is related to emacs, there was explicitly
no attempt to support all emacs' functions, emacs' underlying data structures,
or even high-level. There is not currently a formalized "public API" for pmacs,
although some parts are "more public" than others. The code is somewhat
commented, although currently there is only one author. Buyer beware!

Requirements:
    1. python 2.3 or higher
    2. ncurses

Optional Dependencies:
    1. ispell
    2. aespipe
    3. perl
    4. ctags
    5. cvs
    6. svn
    7. grep

Quick Start Guide:
    1. Download and unpack the pmacs tarball file. After this, there should be
        a directory called "pmacs2" somewhere in your filesystem. It doesn't
        matter where you put this. We'll call the full path to this directory
        PMACSDIR; in future steps substitute the actual path for this symbol.

    2. Create a symlink to PMACSDIR/application.py and put it in a directory
        listed in your $PATH (~/bin, /usr/local/bin, and /usr/bin are all good
        candidates). You can name this symlink whatever you want; I use "pmc".

    3. Try editing a file, by typing "pmc FILE" where FILE is the path to the
        file you want to edit.

    4. Edit the file!

        You can type Control-c and then Meta-h to get a list of all the
        available actions and which key(s) perform them. Type Control-x k to get
        out of the "help buffer". If you have used emacs, many (but not all) of
        these key bindings should seem familiar.

    5. Some basic key bindings:

        C-v (or PG_DN)    move down a page
        M-v (or PG_UP)    move up a page
        C-a (or HOME)     move to the beginning of the line
        C-e (or END)      move to the end of the line
        M-<               move to the beginning of the buffer
        M->               move to the end of the buffer
        M-g               goto line number

        C-s               interactive forward search
        C-r               interactive backward search
        M-%               interactive search-and-replace

        C-]               cancel

        C-/ (or C-x u)    undo last change
        M-/ (or C-x r)    redo last undone change

        C-c M-h           open a buffer listing all available bindings
        C-x k             close the current buffer

        C-x C-s           save your changes
        C-x C-c           quit

        NOTE: the notation used corresponds to the following:
            C-x     hold Control then press x.
            M-x     hold Meta then press x.
            C-c j   hold Control then press c, and then press j
            C-x C-s hold Control then press x, then hold Control then press s

Unfortunately, there is currently no other documentation (besides comments in
the code). Good luck!