HELP

Ozette is an editing shell for software development. It combines a directory
browser, a text file editor, and a command console within a tabbed window
interface modelled on pico/nano. The control keys are based on those typically
used in desktop applications, however, and not on unix shell conventions.

Global commands:
    ^Q - Quit - close all windows
    ^W - Close - close the current window
    ^? - Help - display this help text
    ^-up arrow - open the directory browser or bring it frontmost
    ^-left arrow - move to the next window leftward
    ^-right arrow - move to the next window rightward
    ^-down arrow - open the next file in the directory with the same base name

== Directory browser

The browser tab displays a tree view of the current working directory. Use the
arrow keys to move the selection up or down, or type the name of a file or
directory to select it. Toggle a subdirectory open or closed with the Enter
key. Select a file and press Enter to open it in an editor tab.

Focus in on the current section of the directory tree with the right arrow;
this moves the view toward the current selection by one directory level. Move
back out toward the root of the working directory with the left arrow.

Browser commands:
    ^O - Open - open a file in an editor window
    ^N - New - ask for path and name, then open a new, empty editor
    ^D - Directory - change the current working directory
    ^E - Execute - run some command and log output to the console
    ^F - Find - search for text across all files in the directory
    F5 - Build - save all open files and run make in the working directory


== Text editor

An editor displays the contents of a single file and allows you to make changes.
Type normally to insert text at the cursor. Use the arrow keys to move the
cursor; hold down the shift key while moving the cursor to select a range of
text. Moving the cursor without holding the shift key will drop the selection.
Typing anything will replace the selection with the new text, while pressing
Backspace or Delete will remove the selected text.

Page up and page down move the cursor to the last line of the previous page or
the first line of the next page. Home and end move the cursor to the beginning
or end of the current line.

Cut, Copy, and Paste apply to a single clipboard which is shared across all
editors.

Editor commands:
    ^X - Cut - place selected text on the clipboard, then delete
    ^C - Copy - place selected text on the clipboard
    ^V - Paste - insert clipboard text at cursor location
    ^F - Find - move the cursor to the next occurrence of some string
    ^G - Find Next - find next occurrence of previously found string
    ^R - Replace - find one string and replace it with another
    ^L - To Line - move the cursor to the beginning of the specified line
    ^S - Save - write the contents of the buffer back to disk
    ^A - Save As - write the buffer to disk under a new name/location
    ^Z - Undo - roll back the last change to the document
    ^Y - Redo - reapply the last change which was rolled back


== Shell console

The console displays output logged from commands executed against the current
directory. These may be built-in commands like Find or shell commands invoked
with Execute.

Console commands:
    ^K - Kill - terminate the running command