An editor program lets you use your terminal to: (unnumbered) Write, edit, and inspect any kind of text file (for example, a computer program, chapter in a book, table or figure, or list of names and addresses). Store that file in one of the volumes on your system.

This document describes the PDP--11 Keypad Editor (KED), which can be used on the (iasrsx) IAS, RSX--11 and RT--11 operating system. Information in this document is summarized in the (kedc_book).

KED is an interactive program. You type in text, use keypad function keys, and enter commands. KED displays your text and performs the editing operations you specify. Then it waits for more text and further instructions.

In this document, the interactive relationship between you and KED is called a work session. (unnumbered) (Beginning and Ending Work Sessions---(work_chap))

(work_chap) shows you how to: (unnumbered) Begin a work session to create a file, edit a file, or inspect a file. Set your terminal to best suit the work you want to do. End a work session. (Writing with KED---(writ_chap))

Under KED, your keyboard responds in the manner of an electric typewriter. For example, if you: (UNNUMBERED) Press a character key (letter, number, punctuation mark, or symbol), KED displays the character at the point where the cursor is located. Press (RETURN) (the return key), KED moves the cursor to the beginning of a new line. Press () (the delete key), KED deletes the character preceding the cursor. Press the space bar or (TAB) (the tab key), KED moves the cursor the appropriate number of spaces to the right.

As you type, KED continues to display your text. When you end your work session, KED stores the accumulated text as a file on the volume you specify.

(writ_chap) describes the ways you can use your terminal to type in text and perform text entry operations. (Editing with KED---Chapters (curs_chap\VALUE) and (edit_chap\VALUE))

In addition to giving you the operations of an electric typewriter, KED lets you use your keyboard and keypad to edit (change) whatever you have written in a text file.

Every KED editing operation involves two steps: (NUMBERED) Moving a cursor to the point in your text where you want to make a change Making the change (Moving the Cursor---(curs_chap))

The cursor is a blinking symbol, which shows where you are located in the file.

Some KED function keys and commands let you move the cursor by character, word, line, section, or page. They also let you move the cursor to any character in your text.

The keys you type and the commands you enter to move the cursor are described in (curs_chap). (Making Changes---(edit_chap))

After you move the cursor to the proper location in your text, you can use KED function keys and commands to: (UNNUMBERED) Delete and restore a character, word, line, or larger section of text. Remove a section from one place in your text and insert it in another. Replace a character, character string (two or more contiguous characters), or multiple occurrences of a character string with another character or string that you specify. Convert letter characters from one case to the other (uppercase to lowercase, lowercase to uppercase).

Those and other KED editing operations are described in (edit_chap). (Using Macros and Command Files---(macro_chap))

Since editing operations can consist of a sequence of KED functions and commands repeated over and over, KED lets you create macros (sequences of functions and commands) that you can use as needed.

KED also lets you create command files (sequences of commands) that you can use to preset KED or to complete a work session without typing any keys.

(macro_chap) tells you how to create, store, and use KED macros and command files. (Using Auxiliary Files---Chapters (copy_chap\VALUE) and (insert_chap\VALUE))

To save time while editing text information that is contained in more than one file, KED lets you move text from one file to another. Using KED, you can: (UNNUMBERED) Move all or part of the file you are editing into an auxiliary file. Move all or part of an auxiliary file into any part of the file you are editing.

Those operations are described in Chapters (copy_chap\VALUE) and (insert_chap\VALUE). (Using Journal Files to Protect Your Work Session---(anticipate_chap))

If you begin your work session as described in (work_chap) and your system crashes or another malfunction has the same effect, you will lose all the work you performed. But if you begin your work session as described in (anticipate_chap), you can use a journal file to recover all or most of the work you performed and then continue with your work session. (Special Operations for Programmers---(prog_chap))

In addition to the general-purpose writing and editing operations described in Chapters (work_chap\VALUE) through (anticipate_chap\VALUE), KED gives you some special operations for program development: (NUMBERED) Two ways to insert the escape character For MACRO--11 programs, a renumbering operation that reorders your local symbols For any program you write in a structured language, a structured tab operation that can: (SIMPLE) Insert statements Create multiple levels of indentation Change the indentation level of a group of statements Rewrite indentations to use the most efficient combination of tabs and spaces

Those operations are described in (prog_chap). (Special Procedures for the RT--11 Operating System---Appendix (rt_ax\value) (iasrsx) , (rsx_ax\VALUE) or (ias_ax\VALUE) )

Chapters (work_chap\VALUE) through (prog_chap\VALUE) describe procedures that are specific to KED. (iasrsx) the same for all operating systems. Any differences for the RT--11, RSX--11 and IAS operating systems are described in Appendixes (rt_ax\value), (rsx_ax\VALUE) and (ias_ax\VALUE). (unnumbered) (rt_ax) describes the procedures for the RT--11 operating system. (rsx_ax) describes the procedures for the RSX--11 operating systems. (ias_ax) describes the procedures for the IAS operating system. (rt_ax) describes procedures that are specific to the RT--11 operating system.

(rt_ax) gives you: (unnumbered) Installation information Instructions for using the R, RUN, FRUN, and SRUN commands and the CSI file specification string Specific RT--11 information Instructions for using multiple editors and for printing text without ending your work session (Reference Appendixes)

(opt_ax) lists command line and file specification options.

(func_ax) lists KED functions and commands.

(asci_ax) lists decimal equivalent values for nonprinting ASCII characters.

(session_ax) contains a work session exercise.

(mes_ax) lists KED error and help messages with explanations and problem solutions. (Your Reading Path)

If you have never used KED, you will get the most out of this document by reading Chapters (work_chap\VALUE) through (prog_chap\VALUE) (in that order).

If you have acquired a significant amount of experience with KED, you may want to examine the table of contents or the index in this document, and then read only the sections in this document that apply to your immediate needs.

Regardless of your experience with KED, you may also want to examine (rt_ax) before reading Chapters (work_chap\VALUE) through (prog_chap\VALUE). (rt_ax) contains information that relates KED to your operating system. (numbered)