1 03/05/84  edm
 2 
 3 Syntax:  edm {path}
 4 
 5 
 6 Function: invokes a simple Multics text editor for creating and
 7 editing ASCII segments.  This command cannot be called recursively.
 8 
 9 
10 Arguments:
11 path
12    is the pathname of the segment to be created or edited.  If path is
13    not specified, edm begins in input mode (see "Notes"), ready to
14    accept whatever is subsequently typed as input.  If path is given,
15    but the segment does not yet exist, edm also begins in input mode.
16    If path specifies a segment that already exists, edm begins in edit
17    mode.
18 
19 
20 List of editor requests:
21    ,         comment mode
22    -         backup
23    .         mode change
24    =         print current line number
25    E         execute
26    b         bottom
27    c         change
28    d         delete
29    f         find
30    i         insert
31    k         kill
32    l         locate
33    merge     insert segment
34    move      moves lines within segment
35 
36 
37    n         next
38    p         print
39    q         quit
40    qf        quitforce
41    r         retype
42    s         substitute
43    t         top
44    updelete  delete to pointer
45    upwrite   write to pointer (upper portion of segment)
46    v         verbose
47    w         write
48 
49 
50 Notes: The edm editor operates in response to requests from you.  To
51 issue a request, put edm in edit mode which is entered in two
52 ways: if the segment already exists, it is entered automatically when
53 edm is invoked; if dealing with a new segment (and edm has been in
54 input mode), the mode change character (the period) must be issued as
55 the only character on a line.  The editor announces its mode by
56 typing "Edit." or "Input." when the mode is entered.  From edit mode,
57 input mode is also entered via the mode change character.
58 
59 
60 The edm requests are predicated on the assumption that the segment
61 consists of a series of lines to which there is a conceptual pointer
62 that indicates the current line.  (The top and bottom lines of the
63 segment are also meaningful.) Various requests explicitly or
64 implicitly cause the pointer to be moved; other requests manipulate
65 the line currently pointed to.  Most requests are indicated by a
66 single character, generally the first letter of the name of the
67 request.  For these requests, only the single character, not the full
68 request name, is accepted by the command.  Certain requests have been
69 considered sufficiently dangerous, or likely to confuse you, that
70 their names must be specified in full.
71 
72 
73 For the q (quit) request, if a w (write) has not been done since the
74 last change to the text then edm warns you that changes made may be
75 lost and asks you whether you still wish to exit.  If no changes have
76 been made since the last w, then you exit directly.  The qf (quit
77 force) request bypasses this check.
78 
79 The edm command has three modes--input, edit, and comment.  If the
80 path argument is specified and the segment is found, edm begins in
81 edit mode; otherwise, it begins in input mode.  In edit mode, edm
82 accepts and performs edit requests.  In input mode, all lines typed
83 are appended to the file until a line consisting of a period (.) is
84 typed, causing it to return to edit mode.  In comment mode, one line
85 at a time of the file is printed without carriage return, and you can
86 append to the end of the line by typing a continuation, or can type
87 "." to cause a return to edit mode.