'pico' for Acorn machines - README
==================================

Note that this is NOT an official port of
pico - just a program written to be fairly
similar.

In this distribution are:
        c - directory containing the C source
        h - directory containing C headers
 Makefile - makefile to build executable
     pico - the executable binary
   README - this file

Pico - "PIne COmposer" - is the message editor
for the mail program 'pine'. It is essentially
a cut-down version of EMACS. This version is
lacking even more, since it is just a quick
mock-up written so that I have a CLI-based
text editor for my Acorn machine.

To run, simply type 'pico' at the command
line. To start with a file, type 'pico <file>'
where <file> is the filename.

Other options are -w, -h, -f, -b to set the
screen width, height, foreground colour and
background colour respectively. For instance,
to load file README into a 45x20 editor with
foreground colour 3 and background colour 0:

 pico -w 45 -h 20 -f 3 -b 0 README

This can be useful when using it in !Tasker,
although this version does set the foreground
and background colours to grey and black
respectively if you run it inside !Tasker with
the sprite in the same mode as the Wimp.

The following keys work in pico:
 ^C (control-C) - show current position
 ^E - go to end of current line
 ^J - justify from current row downwards
 ^K - cut marked block / current line
 ^L - redraw screen (probably unnecessary)
 ^O - save file
 ^R - read file to cursor position
 ^U - paste clipboard to cursor
 ^V - page down
 ^W - whereis (see below)
 ^X - quit pico
 ^Y - page up
 ^^ (control and 6) - set mark

... as well as the arrow keys.

The whereis command (^W) allows you to search
for the next occurrence of a word or phrase.
It is case-sensitive. However, if you press
^W followed by ^Y or ^V (page up or page down)
you will instead be taken to the start or end
of the file.

It's a tad buggy and a few commands are
missing, but it will do for me for now, and
fixing the bugs is more than I can be bothered
to do at the moment.

How public-spirited I am... ;>

Any comments, bug fixes, or whatever would be
welcome - you may find my home page at

   http://www.cus.umist.ac.uk/~vivaldi/

and my email address is

   Andrew Wood <vivaldi@ps.cus.umist.ac.uk>

Rest assured, the music package 'Vivaldi' is
written far less shoddily than this... ;)
