chedit(1)

NAME
chedit - CHaracter set EDITor

SYNOPSIS
chedit font

DESCRIPTION
Chedit is a font-editor for psf fonts. It is based upon the similarly-named utility for UCSD Pascal, and shares many of its infuriating qualities, like an almost complete lack of comments, a somewhat baffling user interface, and pitifully inadequate documentation. When Chedit starts up, it clears the screen and throws up a collection of windows, as below:
    ------------------  ---------
    |filename window |  |Charset|
    ------------------  |Window |
    --------- --------  |       |
    |Help   | |Edit  |  |       |
    |Window | |Window|  ---------
    |       | |      |  ---------
    |       | |      |  |Info   |
    --------- --------  ---------
Then sits there waiting for input. When editing, you'll be working in the edit window, which displays the character that you're currently editing. Chedit treats the cursor as a pen, with different pencolors that you can set to draw, erase, or invert bits in the current character, and has motion commands for drawing while you move, as well as moving without drawing anything. Mouse commands are not, however, supported. Perhaps in the next version. Chedit accepts the following commands:

Q   quit chedit. If the character set has been modified, you will be asked if you want to discard the changes.

C   erases the current character. You will be asked if you really want to do this action.

=   copies another character over this character. When you're prompted for a character to copy in, you may type a character, or you may use the ARROW keys to move around the charset window (and select a character by pressing return.)

UNDO
    undoes all changes you've made since you started changing this character (If your terminal doesn't have an UNDO key, ^U takes its place.) or since your last undo.

G   goes to another character. You select the new character just like you would with the = command.

D   sets the pencolor to erase.

A   sets the pencolor to write.

X   sets the pencolor to invert the bit under the cursor.

ESC turns the pencolor off.

The ARROW keys
    on your terminal, as well as the traditional h, j, k, and l keys, are used to move the cursor around the character being edited. Capitol H, J, K, and L do the same, except they also draw on the character with the current pencolor, if you've set one.

b, n, u, y
    are used to move diagonally around the character. Capitol letters do the same, except they also draw.

<   Rotates the current character one column to the left.

F1  Rotates the entire character set one column to the left.

>   Rotates the current character one column to the right.

F2  Rotates the entire character set one column to the right.

{   Rotates the current character one row upwards.

F3  Rotates the entire character set one row upwards.

}   Rotates the current character one row downwards.

F4  Rotates the entire character set one row downwards.

/   Inverts the character. (All set bits are cleared, all clear bits are set.)

F5  Inverts the entire character set.

F6  Flips the entire character set top-for-bottom.

F9  Flips the current character top-for-bottom.

F7  Flips the entire character set left-for-right.

F10 Flips the current character left-for-right.

S   lets you insert or delete a row in the current character. When you type this command, a row is highlighted and a menu is placed at the bottom of the screen, telling you what you can do. You can locate the row by the appropriate arrow keys (and, of course, K and J), then type D to delete this row or Ito duplicate it.

T   lets you insert or delete a column in the current character. This is like the S command, except that you use H and L to move the bar around.

V   visit another character, optionally copying it over the current character. This command asks you to select a character, then displays your selection over the current character, with bits set in the visited character highlighted. You may map this character over the current character with a variety of modes (Or just copies over the old character, Nand erases this character from the old one, Xor erases bits that are set in both characters, otherwise copies the new character over the old, And erases all bits that both characters don't have in common, and finally Quit and ESC simply exit without changing anything, though ESC leaves the outline of the visited character in the editing window.)

R   read a new font, or reread the old one. If you've made changes to the current font, you'll be asked if you want to discard the changes you've made to it.

W   writes the current font out.

!   accepts a command line, then does a shell escape.

SEE ALSO
setfont(8)

NOTES
None of the nonprinting, and the upper 128 characters are not displayed properly in the charset window. USCD Pascal is probably a copyright of the Regents of the University of California.

AUTHOR
David Parsons (orc@pell.com)