e3pi(1)

A mini text editor

Section 1 e3 bookworm source

Description

E3

NAME

E3 - A mini text editor

SYNOPSIS

e3[ws|em|pi|vi|ne] [filename]

DESCRIPTION

e3 is a complete mini application written fully in assembler, with a code size less than 10000 byte. There is a status & input line, where you can enter filenames, blocknames, find-texts and line numbers. The editor commands are similarly the families of Wordstar-like or Emacs or Pico or vi or Nedit editors. For online help press ESC:h in vi mode, else Alt-H. This man page describes Wordstar key bindings only.

KEYBOARD COMMANDS FOR WS

ˆA

Go word left

ˆC

Go page down

ˆD

Go right

ˆE

Go up

ˆF

Go word right

ˆG

Delete current character

ˆH

Delete left character

ˆI

Tabulator

ˆJ

Get online help

ˆKB

Set block start marker

ˆKC

Copy current block

ˆKD

Save file and load a new one

ˆKK

Set block end marker

ˆKQ

Abort editing and exit. Confirm with Y or y that your changes are lost.

ˆKR

Insert a file as a new block

ˆKS

Save file and continue editing

ˆKV

Move current block inside file

ˆKW

Save a block into a file

ˆKX

Save file and exit

ˆKY

Delete text a block

ˆKZ

Suspend (simple ˆZ in other editor modes)

ˆL

Repeat last ˆQF or ˆQA

ˆM

Enter new line

ˆQA

Search & Replace (a prompt appears). For options compare ˆQF.

ˆQB

Go to block begin

ˆQC

Go to end of file

ˆQD

Go to end of line

ˆQE

Go to top of screen: 1st columne, 1st line

ˆQF

Find a text string (a prompt appears). Valid options are Case sensitive and Backward. You could abort via pressing ˆU . This options are equal to e3em, e3pi, e3ne, but their abort keys are ˆG and ˆC.

ˆQG

Delete character under cursor

ˆQG

Delete character left of cursor

ˆQH,ˆQ(Del)

Delete up to line begin

ˆQI

Go to line number (prompt appears)

ˆQK

Go to block end

ˆQR

Go to file begin

ˆQS

Go to line begin

ˆQV

Go to last position of find

ˆQW

Go to previous word

ˆQX

Go to bottom of window (last line, end of line)

ˆQY

Delete to line end

ˆQZ

Go to next word

ˆR

Go page up

ˆS

Go left

ˆT

Delete to next word

ˆU

Undo the last operation. Also abort input in status line (this is used for ˆQI,ˆQF,ˆKR,ˆKW etc.)

ˆV

Toggle insert mode

ˆW

Scroll up

ˆX

Go down

ˆY

Delete current line

ˆZ

Scroll down

UNDO OPERATION DETAILS

e3 has an UNDO mode starting in v2.2. There is no predefined UNDO level count. You can expect to UNDO at least one last insert-, delete-, overwrite- or sed_pipe-operation, but in most cases there are lots of UNDO stages available. e3 has a fixed size undo buffer and will use an external helper file if some deleted data is bigger sized than the undo buffer. This buffer is organized as a ring, overwriting older UNDO information if necessary. So one never can say exactly how many UNDO operations are possible. For using the UNDO press one of:

ˆU

in Wordstar mode

ˆQU

in Pico mode

ˆ_

in Emacs mode

u

in vi command mode

ˆU

in Nedit mode

BUILT IN CALCULATOR

e3 has an arithmetic calculator built in for some simple arithmetic calculations inside your text. Place cursor at begin of the task i.e. something like: -3.002*-(2--3)= and press one of:

ˆKN

in Wordstar mode

ˆQC

in Pico mode

ˆXˆN

in Emacs mode

#

in vi command mode

ˆK

in Nedit mode

This will insert the result into text. Use the values between -999999999999.999999 ... 999999999999.999999 with up to 6 decimal digits and the operators +-*/ and parenthesis ( ). Also available are p for constant PI and r for accessing the result of last calculation

RUNTIME MODE SWITCHING

You can switch to other editor mode by pressing one of:

ˆKM

in Wordstar mode

ˆQM

in Pico mode

altX

in Emacs mode

<ESC>;

in vi command mode

ˆE

in Nedit mode

e3 will set a prompt SET MODE . Now enter one of e3ws, e3em, e3pi, e3vi, e3ne for setting Wordstar-like or Emacs or Pico or vi or Nedit style.

OPTIONS

e3 accepts a filename for text editing. Switch the editor mode depending of the binary name, one of e3ws, e3em, e3pi, e3vi, e3ne

FILES

e3

is an assembled executable for Linux, FreeBSD, NetBSD, OpenBSD, BeOS(tm), QNX(tm). e3ws, e3em, e3pi, e3vi, e3ne are symbolic links to e3.

e3.exe

is an assembled executable for 32 bit Win versions like 95/98/ME/etc.

e3c

is a ’C’ compiled executable for some other platforms, optional built, supporting WS key bindings only.

e3arm

is a new experimental (alpha code quality) assembled executable for ARM Linux, optional built (identical e3, but no arithmetics and no UNDO available).

e3.hlp

help text file (for e3c only)

e3.res

error message text file (for e3c only)

e3-16

e3-16, e3-16.com, e3-16e.exe are special bonus files for 16 bit operating systems ELKS (==Embeddable Linux Kernel Subset) and DOS, supporting WS key bindings only.

COPYRIGHT

e3 is Copyright (c) 2000,01,02,03 Albrecht Kleine

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

BUGS

There probably are some, but I don’t know what they are yet.