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 GNU 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 all high-level functionality of Emacs. 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
    3. bash

Optional Dependencies:
    * aespipe [for aes-encrypted buffers]
    * ctags   [for ctags support]
    * cvs     [for cvs-based commands]
    * grep    [for grep-based commands]
    * ispell  [for spell-as-you-type]
    * perl    [for perl syntax-checking]
    * svn     [for svn-based commands]

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-x C-f           open file in a new buffer
        C-x k             close the current buffer

        C-c M-h           open a buffer listing all available commands/bindings
        M-h               get a help with a command by name
        M-?               get information about a key sequence

        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

    6. Other documentation:

        a. MODES: this file describes in more detail how modes function, and
           how to write your own.

        b. comments in the source code

Good luck!