 HP26EDIT.TXT;5    (DK0:[22,22])  12574 Bytes at  1.2.1985  16:35






  DESCRIPTION  OF  HP26EDIT
  =========================

  HP26EDIT is a FULL SCREEN EDITOR for Hewlett-Packard  Terminals
  2648A + 2649A  and runs as an additional program on all installations,
  where TECO is available  (TECO V36, RSX, VMS).
  No special knowledge of TECO is required.
  Since only the normal typewriter keyboard is used, this program
  may be changed for other teminals too (see TEK4EDIT for TEKTRONIX).


#


Handling of HP26EDIT
--------------------

Call TECO by typing:

>TEC filespec <RET>

Wait a moment, until all programs are loaded.
You will see the top lines of your file  including an automatically
generated new haedline containing actual information about your file.
From now on you can work with normal TECO as usual, or choose the
Full Screen Editor HP26EDIT with:

<ESC><ESC> MM <ESC><ESC>

Press the  H  (HELP) key  and you get a view over the keyboard with all
the associated commands, like this:



-----  Hewlett - Packard  ---  2648  --  2649  ---  Terminal   Keyboard  -----

------------------------------------------------------------------------------
                                                           Top PAGE  End
                                                             ~ <-m-> |
  ESC        1   2   3   4      5   6   7   8   9   0   -    ^ <-m-> \     BS
End of    | Free Q-registers |                              Up SCREEN    1 Line
I,S,R,O                                                            Down    Up
------------------------------------------------------------------------------
TAB    Q     W    E    R    T   Y   U    I     O      P       ` <-d-> {    DEL
     Repeat WORD (EX) Re-  t/T         Insert COM-  X,K,G     @ <-m-> [     _
     Replace         place                    MAND Paragraph |<--LINE-->|
------------------------------------------------------------------------------
CTRL   A     S      D     F    G   H    J    K      L   + <-d-> *    }      R
                                                        ; <-m-> :    ]      E
    Repeat Search Delete (FS) Get HELP Jump Kill+ X,K,G  | WORD|   Up in    T
    Search        Found      Unsave     to  Save   Line             Line
                             W,L,B,P   Mark W,L,B,P                /        1
-------------------------------------------------------------------------  Line
 SHIFT  Z     X    C    V      B      N      M     < <-d-> >   ?   SHIFT   Down
                                                   , <-m-> .   /
     CTRL/Z  Save            X,K,G  Global  Mark,    CHAR.    Down
     ->TEC* W,L,B,P          Region Search MM=hpEDIT         in Line

               ------------------------------------------
               |    S P A C E   =   Screen  Refresh     |
               ------------------------------------------

( m = move,  d = save + delete )

You will recognize the 4 PAIR OF KEYS at the right for cursor movement
or deletion of text.

Press <SPACE> to return to your text.
#


CURSOR MOVEMENTS
----------------

<RETURN>      Move cursor to the beginning of the next line.
<BACK SPACE>  Move cursor to the beginning of the previous line.

/	Move cursor down one line but leaving it in the line
	(as good as possible).
]	Move cursor up one line and remain in the same column.

.	Move cursor right one character.
,	Move cursor left  one character.

	At the end of a line a 'cl' is printed, to show you that there
	are two ASCIISs <CR>+<LF>, and to give a hint where you are.

:	Move cursor to the beginning of the next word.
;	Move cursor to the beginning of the previous word.

[	Move cursor to the end of the line
	(in front of <CR><LF>,  to extend the line).
@	Move cursor to the beginning of the line.

\	Move cursor 20 lines further on  and show the new (screen) page.
^	Move cursor 20 lines up  and display the (screen) page.

|	Move cursor to the end of your text buffer (EOPage).
~	Move cursor to the top of your text buffer.

J	Cursor is moved to the previously defined MARK (with M).


<SPACE> Rewrite screen with centered cursor.

2 x <SPACE> with 'DISPLAY FUNCTIONS' key pressed down  will show you
	the page with all function characters displayed, so as
	CR, LF, FF, Horizontal Tab, CTRL/..., so you can search
	optically for hidden ASCIIs.



SAVE,  DELETE,  KILL,  GET
--------------------------

Delete CHARACTERS:

>	Delete one character at cursor (above the underlining cursor).
	Nothing is saved.
	Behind the end of text in a line you must delete twice <CR+LF>,
	to combine two lines.
<	Delete character left to the cursor.
#

The commands SAVE, DELETE, KILL, and GET build a community:
 -1 They work on entities of  a word, a line, a freely selected region,
    or a paragraph.
 -2 Before deletion  these entities will be stored in one of 4 special
    registers,  so they can be re-inserted somewhere later by the GET
    command  (W-, L-, B-, and P-Register).

*	Delete the next WORD.
	Delete and save in the  W-register all characters from the
	cursor position to the end of the nearest word to the right.
	If you are in the middle of a word, the rest will be saved
	and deleted.
	Words in this context means: ALPHANUMERICS.
	<CR>,<LF> are not words, these remain untouched.
+	(Delete the previous word, is not implemented)

{	Delete all from the cursor position to the end of the LINE
	(without <CR>+<LF>). Save this in the  L-register.
`	Delete all from the beginning of the LINE to the cursor
	position. Save it in the  L-register.


KILL + SAVE of entities:  (DELETE, CUT)

KW	Kill the WORD you are in  and save it in the  W-register.

KL	Kill the whole LINE without notice where you are
	and save it in the  L-register.

KB	Kill a selectable REGION of text.  (Region = Bereich)
	First define the beginning of the text by moving the cursor
	to it and press  M. This will set the MARK (in reverse).
	Then move (up or down) to the end of your region and type  KB.
	Everything between this is saved in the  B-register  and deleted.

KP	Kill the PARAGRAPH in which the cursor is  and store it in the
	P-register. (Everything between two <CR-LF-CR-LF>-combinations).

K<ESC>	Kill nothing.  If you have hit  K, the bell will sound to get
	your attention. If K was a mistake, press <ESC> and nothing
	will be done.


SAVE (without deletion) of entities:

XW, XL, XB, XP:
	Save a word, a line, a region, and a paragraph in the same way
	as above in the registers  without touching the text buffer.

XX	Save the contents of the line from cursor position to the
	beginning of the next line (inclusive <CR,LF>) in the
	X-register.
	In addition to register X you can use  C, V, G, 1...4 in old
	TECO manner (look for free registers: above the HELP-lines:
	press H and ROLL DOWN ).
#

GET TEXT OUT of the registers   (PASTE, UNSAVE):

GW, GL, GB, GP, GX:
	Re-insert at cursor position everything which is in one of the
	36 TECO registers, especially the 5 former filled registers.
	The cursor is set to the beginning of the inserted text
	for further alterations.


INSERTION of text:
------------------
Insertion of any text including all special CTRL/-Characters  is done
in TECO manner by typing  'I', then your text, and close it up with
one or two <ESC>.
The 'DEL'-Delete key for backwards deletion of input works as usual.
If you are in input mode the rightmost LED (INSERT CHAR) will be
blinking.  A free space and a bar shows you where you are inserting.

Insertion of lower/upper case = small/capital letters:
Since the 'CAPS LOCK' key must be up to get correct key information
for the commands, we must have another means to switch from
LOCKED CAPITALS to mixed small and Capital Letters. This is done by
the  t/T-Flip-Flop. It can be switched in one of the two ways:
 -1 If you are in normal command mode  press 'SHIFT/T' for CAPITALS ONLY
    or 't' for mixed characters. Then do your insert.
 -2 If you already are in insert mode  type  CTRL/T  to change the case.
The case will continue till the end of the session or till it is
switched, and will include the commands REPLACE and FS.

In the beginning of a session normally all input (with CAPS LOCK up
and witout SHIFT keys used) is converted to CAPITAL LETTERS (for
program edition).



SEARCH for a string.  (FIND):
-----------------------------
S	Press 'S', type in the 'string' you are searching for
	and an <ESC>.
	Only searching down is possible (otherways go up one (screen)
	page and search). Capital and small letters are treated in the
	same way.

A	Repeat the search.  (FINDNEXT):
	Search for the last defined 'string' again.

D	Delete the 'string' that was found.

R	Replace the 'string' that was found by a new 'text'
	in the same manner as in insert mode. Close it up with <ESC>.

Q	Repeat Replace.  (SELECT + CUT + PASTE):
	Only press  Q. The last found 'string' will be replaced by
	'text', lastly defined in Replace.

N	Global search over (buffer) page boundaries through to the end
	of your file.
#

Ordinary TECO COMMANDS:
-----------------------
O	After  O  you can define all normal TECO commands, closing up
	with <ESC><ESC>.  E.g. <FSabc$def$>$$,  5XX$$.
or
CTRL/C
CTRL/Z	Return to normal TECO editor, when in Full Screen Mode,
	and give your commands.

MM <ESC><ESC>  If you are in normal TECO Editor, you get into the
	Full Screen Editor HP26EDIT by calling the Macro M.


EXIT
----

EX	EXIT,  all is saved in the new file.

3 times CTRL/C
3 times CTRL/Z  (QUIT)  Get out of the Editor. Files are not  touched.

--------------------------------------------------------------------------


ENVIRONMENT and INSTALLATION
----------------------------

This system works with a PDP11/34, RSX11M V3.2, TECO V36, hp-Terminals
of the 2648A and 2649A type. 9600 Baud. Sometimes a write or positioning
error may occur. This is due to hp-CPU-latency  or mismatching in
conjunction with a long cable.

To use HP26EDIT you must have 2 programs  besides TECO:
Place the Macro HP26EDIT.TEC anywhere in LB:[1,1], [1,2] or so.
Write a new  TECO.INI  for your own UIC. This  TECO.INI  containes
one line only:
@EI/LB:[1,2]HP26EDIT.TEC/<RET>
It loads the  HP26EDIT.TEC Macro into your buffer when TECO is called.

Only the normal typewriter keyboard is used. Dont touch the function
keys.
All keys are up, except REMOTE.

BELL:	The BELL sounds, when special attention is desired:
	-1 after  K (Kill),
	-2 the searched 'string' could not be found,
	-3 if a key has no effect, you hit the wrong key.
#

Special PROGRAM and FILE HANDLING
---------------------------------
If you don't want to use the Screen Editor at all,
or if your file is TOO LONG to fit into the text buffer
(together with HP26EDIT) (24k Bytes), call TECO by:

>TEC filespec/NOI <RET>    = No initialisation.

Then cut your file into two pages by inserting a  CTRL/L = Form Feed
somewhere between lines, make EX  and call TECO again:


>TEC filespec <RET>

To get a new (buffer) PAGE  type:
P  It writes the contents of the work buffer into the new file and
   reads a new page from the old file into that buffer.

There will be a Memeory File in your UIC (TECF00.TMP) which remembers
file specifications from the last call for TECO.  So if you want to
work on the same file again, only type:

>TEC<RET>.



KNOWN DISADVANTAGES:
--------------------
1. It is not possible to work on lines longer than 80 columns correctly.
   TECO uses the line as an entity, while hp automatically induces a
   wrap-around (<CR-LF>), so the connection between both is lost.
   If you meet superlong lines  cut them into pieces or shorten them
   beginning from the top of the screen downwards, using Refresh Screen
   <SPACE> as often as necessary.

2. If you are starting a new file  there are some difficulties with the
   correct positioning of the cursor. Sometimes lines seem to be over-
   written (by hp). Dont bother, trust your fingers. To look at all use
   <SPACE>, '~' and '|'.

3. If the initial TAB-setting is not correct in 8 ASCIIs distance you
   get a mismatch of character positions. Just make a  CTRL/Z  and
   MM <ESC><ESC>  to get a new TAB-setting.

4. Nobody is perfect.


Good Luck  wishes the author !


  D. Glasenapp  KFA/IFF JUELICH
		Postfach 1913
		D - 5170 JUELICH
		West-Germany

		Tel.: 02461/614008




EEEEEEE
