Go to file
moculus e23578d82c term term term TERM
--HG--
branch : pmacs2
2008-10-18 02:03:27 +00:00
code_examples rst 2008-10-16 02:49:28 +00:00
method ignore-suffix for opening files 2008-10-15 21:17:16 +00:00
mode term term term TERM 2008-10-18 02:03:27 +00:00
tools remove slurp dependency 2008-06-20 02:05:28 +00:00
BUGS undo id--awesome 2008-08-20 01:10:47 +00:00
IDEAS --HG-- 2008-09-21 05:47:18 +00:00
MODES documentation updates 2008-04-17 14:30:38 +00:00
README this is a multi-line change comment, with whitespace. 2008-04-16 05:07:41 +00:00
aes.py changes to move toward python3 2008-03-16 20:08:37 +00:00
application.py term term term TERM 2008-10-18 02:03:27 +00:00
buffer.py term term term TERM 2008-10-18 02:03:27 +00:00
bufferlist.py more better mini-buffer/completion buffer 2008-05-04 06:40:30 +00:00
cache.py try this again 2007-03-06 15:05:38 +00:00
color.py --HG-- 2007-07-18 11:22:12 +00:00
completer.py ignore-suffix for opening files 2008-10-15 21:17:16 +00:00
context.py --HG-- 2008-05-12 22:12:56 +00:00
default.py validation... 2008-05-19 02:05:29 +00:00
dirutil.py method bugfixes, doc updates, other improvements 2008-03-18 14:51:47 +00:00
edb.py python-mode improvements; context 2008-05-11 23:40:06 +00:00
exceptions.py --HG-- 2008-05-11 23:59:35 +00:00
gdb.py --HG-- 2008-03-28 22:16:59 +00:00
highlight.py --HG-- 2008-09-12 14:43:15 +00:00
ispell.py turned ispell into a stand-alone script 2008-03-16 22:47:54 +00:00
keyinput.py --HG-- 2008-03-14 21:17:04 +00:00
lex.py rst 2008-10-16 02:49:28 +00:00
minibuffer.py v2.6 clean-up 2008-03-16 20:26:32 +00:00
miniparse.py search is better, other stuff is worse 2007-07-05 20:18:09 +00:00
point.py point2->point and buffer2->buffer 2007-10-22 00:50:11 +00:00
regex.py improved python function support 2008-03-21 06:29:03 +00:00
render.py improved highlighted-region support 2008-05-03 20:22:12 +00:00
searchutil.py started moving to newer-style exception (finally) 2008-05-16 23:02:22 +00:00
tab.py --HG-- 2008-10-06 19:05:02 +00:00
term.py term term term TERM 2008-10-18 02:03:27 +00:00
util.py fix for netbsd/alpha 2007-08-20 01:58:02 +00:00
window.py term term term TERM 2008-10-18 02:03:27 +00:00

README

Pmacs

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.4 or higher
    2. ncurses
    3. bash

Optional Dependencies:
    * aespipe  [for aes-encrypted buffers]
    * ispell   [for spell-checking]
    * cvs      [for cvs-based commands]
    * svn      [for svn-based commands]

    * perl     [for perl syntax-checking]
    * gcc      [for c compilation/syntax-checking]
    * make     [for c compilation]
    * latex    [for LaTeX compilation]
    * pdflatex [for LaTeX PDF rendering]
    * disinst  [for x86 instruction parsing]

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 key bindings
        C-c M-?           open a buffer listing all available functions
        M-?               get a help with a command by name
        M-h               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 and press x.
            M-x     hold Meta and press x.
            C-c j   hold Control and press c, then press j
            C-x C-s hold Control and press x, then hold Control and press s

    6. Other documentation:

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

        b. other help commands

        c. comments in the source code

Good luck!