Enter your search terms Submit search form
	Web pdp-10.trailing-edge.com

.;PS:TECO.RND[34,52,DOC], 17-Sep-81 11:03:34, Edit by BOB MCQUEEN[10,52]
.;PS:TECO.RND[34,52,DOC], 16-Sep-81 22:32:55, Edit by BOB MCQUEEN[10,52]
.;PS:TECO.RND[34,52,DOC], 15-Sep-81 20:39:33, Edit by BOB MCQUEEN[10,52]
.;PS:TECO.RND[34,52,DOC], 12-Sep-81 21:52:25, Edit by BOB MCQUEEN[10,52]
.;TECO Documentation
.;Original version produced at BYU by SLP.
.;Modified by CBD for general version and on-line help system.
.;Updated at Stevens to include new commands and to use DSR.
.;12-Sep-81	note: Date change here and in two other places.
.;RUNOFF switches
.;*****WARNING******  TECO.CRD and TECO.DOC must be post-processed
.;                    to remove control characters.  See TECDOC.MIC.
.;TECO.CRD=TECO.RND/variant:card/creturn
.;		(makes a 60x40 output file for 3-panel reference cards)
.;		then use RUNFIL.TEC and 3X60.FOR to make finished card.
.;TECO.CRD=TECO.RND/variant:(card,ut)/creturn/underline:line
.;		(makes a 75X49 output file suitable for photo-reduced
.;		reference cards (Univ. of Texas Format).)
.;TECO.DOC=TECO.RND/variant:doc/underline:separate
.;		makes a 58x70 TECO command summary for DOC:.
.!		Printable on regular 8.5 by 11 paper.
.;HINTS.TEC=TECO.RND/variant:hints/underline:separate
.;		makes a HINTS.TEC file for placement on TED:.
.!TECHLP.TXT=TECO.RND/variant:help/creturn/underline:none
.!		makes a help text suitably formatted for the TECO On-Line
.!		Help System.

.vr help t f
.vr card t f
.vr hints t f
.vr doc t f
.vr ut t f
.style headers 6,0,0
.ap
.cc
.if card
.ps 60,40
.if ut
.ps 75,49
.ei ut
.ei card
.if help
.ps 99999,70
.nj
.nhd
.ei help
.if doc
.flag substitute
.ps 58,70
.header mixed
.t TECO Command Summary
.st Table of Contents
.date
.fg4
.c;TECO Command Summary
.s2
.c;$$MONTH#$$DAY,#$$YEAR
.NO FLAG SUBSTITUTE
.s 2
.c;Table of Contents
.s
.REQUIRE "TECO.RNT"

.pg
.ei doc
.if card
.ifnot ut
.c;TECO REFERENCE CARD
.else ut
.c;TECO POCKET REFERENCE LIST
.s
.c;DECsystem-10
.c;CCRL-7
.ei ut
.ei card
.if doc
.c;TECO Command Summary
.ei doc
.if card
.s.c;September 12, 1981
.ifnot ut
.s.c;* * *
.s
.else ut
.s20
.ei ut
.ei card
.if doc
.s
.i5
.ei doc
.if help
.lit

HELP  Welcome to the TECO On-Line HELP System.

 - To get back to TECO, type an altmode or a carriage return.
 - To get help on a command, type it followed by an altmode.
   ^H, DEL, ^U and ^R can be used during type-in, but note
   that other control characters are converted to <up-arrow><char>.
 - To get help on one of the following categories, type the
   category number followed by an altmode.  The categories are:
    1. Symbols and Definitions      15. Advanced Insertion
    2. Creating and Editing a File  16. Deletion
    3. Exiting from TECO            17. Immediate Type-Out Commands
    4. Buffer Positions             18. Type-Out
    5. Pointer Positioning          19. Advanced Terminal I/O
    6. Arithmetic Operators         20. Searching
    7. File Selection               21. Advanced Searching
    8. Advanced File Selection      22. Q-Registers
    9. File Selection Switches      23. Iteration Commands
   10. Log Files                    24. Flow Control
   11. Terminal Initialization      25. Conditional Execution Commands
         and Video editing
   12. Input                        26. Special Numeric Values
   13. Output                       27. Aids
   14. Insertion
 - To do a general search for any string in the entire help file,
   type it followed by a carriage return.
 - To see the entire help text, type "ALL" followed by an altmode.
   (If you'd like a printed copy, print DOC:TECO.DOC.)
 - To see this text again, type "HELP" followed by an altmode.
 - For more detailed information, see the TECO Reference Manual
   and the file DOC:TEC200.DOC.  Other useful material can be found
   on the TED: area.

ALL
.end lit
.ei help
.ifnot hints
.ifnot help
For complete descriptions and examples of TECO's
commands, refer to the TECO manual and
DOC:TEC200.DOC.
.ei help
.ei hints
.if card
.ifnot ut
.s.c;* * *
.ei ut
.ei card
.if doc
.s.c;* * * * * * *
.ei doc
.ifnot hints
.lm 14
.ts 14,22,30,38,46
.ei hints
.if card
.lm 9
.p -9,1,2
.ts 9,16,24,32,40
.ei card
.if help
.p -14,1,0
.ei help
.if doc
.p -14,1,2
.st Symbols and Definitions
.ei doc
.tp 10
.s2
.if help
 
1
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Symbols and Definitions
.lm14
.endif doc
.ifnot doc
.c;^&Symbols and Definitions\&
.endif doc
 
_^	Designates the following letter or character as
a control character.  In general, TECO will allow you to type a control
character in the "<up-arrow><character>" form, unless it is part of
a text string within a search or insert command.
 
$	Altmode or escape key (_^[).
 _<CR_>	Carriage return key (_^M).
 _<LF_>	Line feed key (_^J).
 _<TAB_>	Tab key (_^I).
 _<FF_>	Form feed key (_^L).
 m or n	Represents any integer number. Many TECO commands accept
a numeric argument, which, if missing, generally defaults to 1.
 i	Represents a Q-register name.  A Q-register name is either a character
string enclosed in parenthises or one of A-Z, 0-9, *, %, _. ?,
_(character-string_).
 Buffer	A block of memory within TECO
into which text is read or inserted, edited, and output.
 Page	The amount of text read into the buffer by an input command or
output by an output command.
Editing is performed in the buffer on a page by page basis.
 Buffer Pointer
.br;Represents the current position within a buffer where editing
is taking place; always positioned between two characters.  There is one
buffer pointer for each buffer.
 Q-registers	Data storage locations available as text buffers, numeric
storage, or TECO command buffers.
.ei hints
.if card
 Filespec	dev:filnam.ext_[proj,prog,
.br;sfd1,sfd2,...]/sw1/sw2...
.ei card
.ifnot hints
.ifnot card
 Filespec
.br; #####node::dev:filnam.ext_[proj,prog,sfd1,sfd2,..]/switch1/switch2..
 Node names are parsed and checked for validity, but are not supported at
this point in time.  The central site node name is the only name allowed.
.ei card
.ei hints
.if doc
.st Creating and Editing a File
.ei doc
.tp 10
.s2
.if help
 
2
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Creating and Editing a file
.lm14
.endif doc
.ifnot doc
.c;^&Creating and Editing a file\&
.endif doc
.s;The following monitor commands automatically run the
TECO editor and perform standard file initialization.
 
MAKE filespec_<CR_>
.br;Create a new file with TECO.
Performs an automatic EWfilespec$.
 
TECO filespec_<CR_>
.br;Edit an existing file with TECO.
Performs an automatic EBfilespec$EY$ sequence.
 
TECO_<CR_>	Enter TECO using the file named in the previous edit.
 
MAKE filespec1=filespec2_<CR_>
.br;TECO will create "filespec1" from "filespec2".
(Performs an automatic EWfilespec1$#ERfilespec2$#EY$ sequence.)
A "TECO" command will always ignore the second
filespec if given, causing filespec1 to be editted normally.  This allows
"TECO#_<CR_>" commands following a MAKE command to continue
to edit the newly created file rather than read from the
original one again.
 
TECO filespec
$command$...$command_<CR_>
.br;Execute the specified commands following the filespec automatically after
entering TECO (works with MAKE too). The command string
will be remembered as part of the filespec on subsequent
"TECO<CR>" commands.
Note that the "$" characters shown are dollar-signs, not 
escapes.  Since real escapes on the command line would cause the command
to terminate prematurely, we make use of a "pseudo-escape"
character, the dollar sign.  TECO will substitute real escapes
as it executes the command(s).
 
R 
TECO_<CR_>	Run the TECO editor without selecting any files
for editing.
File selection must be made with the TECO commands described
under "File Selection".
.ei hints
.if doc
.st Exiting from TECO
.ei doc
.tp 10
.s2
.if help
 
3
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Exiting from TECO
.lm14
.endif doc
.ifnot doc
.c;^&Exiting from TECO\&
.endif doc
 
EX	Output the remainder of the input files, close the
output files, and then exit to the monitor.
If an ED command is in effect, run the specified program.
 
EG	Output the remainder of the input files, close the output files
and then re-execute the last compile class command that was typed.
 
_^C	Exit immediately to the monitor.
May also be used to abort an editing session (leaves original
file intact). Typing CONTINUE (perhaps after performing some monitor commands)
will allow you to resume your editing session where you left off.
Typing REENTER will cause TECO to abort any command string it may
have been executing and ask for the next command. (This is good
for stopping infinite search loops, etc.)  _^C can be entered in the command string by
typing it as up-arrow C.
 
_^Z	Close the output file and exit to the
monitor.
(Simple close; no files are renamed).
.ei hints
.if doc
.st Buffer Positions
.ei doc
.tp 10
.s2
.if help
 
4
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Buffer Positions
.lm14
.endif doc
.ifnot doc
.c;^&Buffer Positions\&
.endif doc
 
B	Beginning of the buffer_; 0.
 
_.	Current pointer position; number of characters
to the left of the pointer.
 
Z	End of the buffer; number of characters in the
buffer.
 m
,n	m+1st through nth characters in the buffer.
Used with the K, P, S, T, and X commands.
 
H	Entire buffer; B,Z.
.ei hints
.if doc
.st Pointer Positioning
.ei doc
.tp 10
.s2
.if help
 
5
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Pointer positioning
.lm14
.endif doc
.ifnot doc
.c;^&Pointer positioning\&
.endif doc
 n
J	Move pointer to position between nth and
n+1st characters.  If n is ommitted, the value will default to zero.
 n
EJ(Q-reg)	Move the pointer to the position between the nth and
n+1st characters in the specified Q-register.  If n is ommitted, the value
will default to zero.
 n
C	Advance pointer n positions.
 n
R	Move pointer back n positions. Equivalent to -nC.
 n
L	Move pointer to beginning of nth line after current pointer position.
 
0L	Move pointer to beginning of current line.
 n
_^D	Move the pointer on the screen up or down n lines.  This
command is valid only if "VIDEO" mode is enabled by an EVON$ command.
.ei hints
.if doc
.st Arithmetic Operators
.ei doc
.tp 10
.s2
.if help
 
6
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Arithmetic Operators
.lm14
.endif doc
.ifnot doc
.c;^&Arithmetic Operators\&
.endif doc
 m
+n	Add m and n.
 m
 n	Add m and n.
 m
-n	Subtract n from m.
 m
*n	Multiply m by n.
 m
/n	Divide m by n and truncate the result.
 m
_&n	Bitwise logical AND.
 m
_#n	Bitwise inclusive OR.
 
(
)	Perform enclosed operations first.
 
_^On	Accept following number in octal radix.
Must be typed as up-arrow O.
.ei hints

.if doc
.st File Selection
.ei doc
.tp 10
.s2
.if help
 
7
.ei help
.ifnot hints
.if doc
.lm0
.HL1 File Selection
.lm14
.endif doc
.ifnot doc
.c;^&File Selection\&
.endif doc
.s;The following commands may be used to control
file selection.
 
ERfilespec$	Select file for input.
 
EWfilespec$	Select file for output.
 
EBfilespec$	Select file for input and output, and save the
original file as the same name, but the extension BAK.
 
EAfilespec$	Select file for output--append rather than supersede.
.ei hints
.if doc
.st Advanced File Selection
.ei doc
.tp 10
.s2
.if help
 
8
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Advanced File selection
.lm14
.endif doc
.ifnot doc
.c;^&Advanced File selection\&
.endif doc
 
EP(Q-reg)filespec$
.BR;Read a file and put it into the specified Q-register.
If no Q-register is specified, then it will default to *.
 
EI(Q-reg)filespec$
.BR;Read a file, put it into the specified Q-register,
and execute it as a TECO macro.  If no Q-register is specified, then it
will default to *.
 
EQ(Q-reg)filespec$
.BR;Write the text from the Q-register into a file.
 
ENfilespec$	Rename the current input file to filespec.
 
EN$	Delete the current input file.
 
EEfilespec$	Save the current state of TECO in filespec.
DSK:TECO.SAV is the default.
 n
EDfilespec$	Run filespec upon exit.  (SYS_: is the default device.
The optional argument n is the starting address offset).  Optional switches
are /RUNCOR:n and /RUNOFFSET:m.
 
ED$	Cancel pending ED (do not run
anything on exit from TECO).
 
EK	Cancel existing EW or EA.
 n
EM	Position magnetic tape.
 
EZfilespec$	Zero directory (DECtape) and select file for output.
 
E.(Q-reg)	Used to select Q-register for editing.  The initial editing
buffer is associated with Q-register '(.)' (period).
.ei hints

.if doc
.st File Selection Switches
.ei doc
.tp 10
.s2
.if help
 
9
.ei help
.ifnot hints
.if doc
.lm0
.HL1 File Selection Switches
.lm14
.endif doc
.ifnot doc
.c;^&File Selection Switches\&
.endif doc
.s;These switches may also be used with the
MAKE and TECO monitor commands.
 
/READONLY	Used with TECO command to cause ER instead of EB.
 
/INPLACE	Used with EB to cause file to be overwritten with
no .BAK file.
 
/APPEND	Used with MAKE command to cause EA instead of EW.
 
/DEFAULT	Used with ER, EW, EA, EB, EI, EQ and EP to cancel
any filespec defaults previously in effect.
 
/NODEFAULT	Performs the ER, EW, EA, EB, EI, EQ or EP without modifiying
and current defaults.
 
/GENLSN	Used with EW or EB to cause line sequence
numbers to be generated.  This is equivalent to /MODE:LSA or /OMODE:LSA.
 
/SUPLSN	Used with ER, EB, or EW to suppress line
sequence numbers.  This is equivalent to /MODE:LSA or /IMODE:LSA.
 
/IMODE:mode	This switch is used to EB to specify the input mode.
The modes are the same that are valid on the /MODE: switch.
 
/OMODE:mode	This switch is used to EB to specify the output mode.
The modes are the same that are valid on the /MODE: switch.
 
/MODE:ASCII	Used with ER, EW, EA, EB, EI, EQ and EP to cause the
file mode to be buffered ASCII.
 
/MODE:DUMP	Used with ER, EW, EA, EB, EI, EQ and EP to cause dump mode
I/O to be used to read or write the file.  This causes the entire file to be
read into core.
 
/MODE:LSA	Used with the ER, EW, EA, EB, EI, EQ and EP commands to
cause the file to have line sequence numbers generated on output and removed
on input.  This is the same as /SUPLSN and /GENLSN.
 
/MODE:SIXBIT	Used with the ER, EW, EA, EB, EI, EQ and EP commands to
specify that the file is a COBOL SIXBIT file.
 
/PROTECTION:nnn	Used with EW, EA, EB, EZ and EQ commands to specify
the file protection assigned.
 
/VERSION:ver	Used to set the output version number of the file.
.ei hints
.if doc
.st Log Files
.ei doc
.tp 10
.s2
.if help
 
10
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Log Files
.lm14
.endif doc
.ifnot doc
.c;^&Log Files\&
.endif doc
 
ELfilespec$	Open a log file. Default is
DSK:TECO.LOG.
 n
EL$	Further control of log file: 0=nothing in log, 1=/NOIN,
2=/NOOUT, 3=everything in log, 4=Dump video update information in
log, -1=close the log file.
 
/NOIN	Used with EL to keep terminal input out of the log file.
 
/NOOUT	Used with EL to keep terminal output out of the log file.
 
/APPEND	Used with EL to append to rather than supersede the log
file.
.ei hints
.if doc
.st Terminal Initialization and Video editing
.ei doc
.tp 10
.s2
.if help
 
11
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Terminal Initialization and Video editing
.lm14
.endif doc
.ifnot doc
.c;^&Terminal Initialization and Video editing\&
.endif doc
.ifnot doc
 
EVterminal$	Specifies terminal type. (ACT4, ACT5, ADD580, ADM2,
ADM3, ADM3A, BEE, CDC, CRT, DM1520, DPT, H19, H19A H1200, H1500, H1420, H2000,
HMOD1, HMOD1I, HP2640, RGNT25, TELRAY, TELVID, TK4025,
VT05, VT100, VT132, VT50, VT52, and TTY).
TECO is initialized to CRT.
.else doc
 
EVterminal$	Specifies the terminal type.  The terminals that
are supported are:
.b
.LM26.TS 26
.P -12,0,2
 ^&Name\&	^&Terminal\&
.B
 ACT4	ACT-IV.
 ACT5	ACT-V.
 ADD580	ADDS Consule 580.
 ADM2	LSI ADM-2.
 ADM3	LSI ADM-3.
 ADM3A	LSI ADM-3A.  (Video editing supported).
 CDC	CDC(?) terminal.
 CRT	General CRT.  Causes deletes to erase the character.
 DM1520	Datamedia 1520 and 1520A.  (Video editing supported).
 DPT	Datapoint.
 H19	Heathkit H19 in VT52 mode.  (Video editing supported).
 H19A	Heathkit H19 in ANSI mode.  (Video editing supported).
 H1200	Hazeltine 1200.
 H1500	Hazeltine 1500.
 H1420	Hazeltine 1420.  (Video editing supported).
 H2000	Hazeltine 2000.
 HMOD1	Hazeltine Mod-1.
 HMOD1I	Hazeltine Mod-1 with insert/delete line.
 HP2621	HP 2621 terminal.  (Video editing supported).
 HP2640	HP 2640.
 HP2648	HP 2648 terminal.  (Video editing supported).
 RGNT25	ADDS Regent 25.  (Video editing supported).
 TELRAY	Teleray.  (Video editing supported).
 TELVID	Televideo.  (Video editing supported).
 TK4025	Tektronics 4025.  (Video editing supported).
 TTY	Hardcopy terminal.
 VT05	DEC VT-05.  (Video editing supported).
 VT100	DEC VT-100.  (Video editing supported).
 VT132	DEC VT-100 in 132 wide mode.  (Video editing supported).
 VT52	DEC VT-52.   (Video editing supported).
 VT61	DEC VT-61.  (Video editing supported).
.LM14
.TS 14,22,30,38,46
.P-14,1,2
.endif doc
 
EVparameter$	Sets a parameter or returns a value depending on
the parameter.
.ifnot doc
Parameters that return values are: NODE, LINE, TRMOP, WINDOW.  Other parameters
are: ON, OFF, UPDATE, REFRESH.
.else doc
.LM26.TS 26
.P -12,1,2
.B
 ^&Paramter\&	^&Description\&.
 NODE	This command will return as a value the node number that the user's
teminal is connected to.
 LINE	This command will return a value that is the line number that the
user's teminal is connected to.
 TRMOP	This command will cause a TRMOP_. UUO to be executed.  This
command will return a value if the TRMOP_. is executing a read function and
no value will be returned if it is executing a set functions.  All functions
are to the terminal that TECO is currently connected to.  The first argument
is the value to set and the second argument is the function number.  Only those
function codes over 1000 (octal) are valid.
 WINDOW	This command will return the screen size that TECO is using.
The value is number of lines * 1000000 (octal) + width.
 ON	Causes the Q-registers that have been set up by the E$ command to
be displayed on the screen on there respective lines.  This command will
turn on "VIDEO" editing for TECO.
 OFF	Causes TECO to not display any Q-registers.  TECO will act in a manner
similar to DEC TECO.  This command will turn off "VIDEO" editing.
 UPDATE	Causes the screen to be updated immediately.  This is only valid if an
EVON$ command has been issued.
 REFRESH	Causes the screen to be refreshed.  This command is only
valid if an EVON$ command has been issued.
.LM 14
.TS 14,22,30,38,46
.P -14,1,2
.endif doc

 n,m
E$(Q-reg)$
.BR;Causes the specified Q-register to be displayed on
the nth through mth lines on the screen.  The lines number start at one.
The text will not be displayed until the EVON$ command has been issued.
.ei hints

.!INPUT
.if doc
.st Input
.ei doc
.tp 10
.s2
.if help
 
12
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Input
.lm14
.endif doc
.ifnot doc
.c;^&Input\&
.endif doc
 
EY	Clear buffer and input one page.
(Y may be used at macro level).
 
A	Input one page and append to current buffer
contents.
 
:n
A	Input n lines of text and append to current buffer contents.
(Won't read past a form feed.)
 n
_^Y	Input until page n is in the buffer.
 n
_^U	Perform a USETI. Positions input file to block n
for next input command. (ER'd files only; illegal with EB).
Must be typed as up-arrow U.
.ei hints
.if doc
.st Output
.ei doc
.tp 10
.s2
.if help
 
13
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Output
.lm14
.endif doc
.ifnot doc
.c;^&Output\&
.endif doc
 n
PW	Output n copies of the current page and append a form
feed character to each.
Does not change the buffer.
 n
P	Output the current page, clear the buffer,
and read in the next page.  Continue this
process until the nth page from the current
page has been input.
 m
,n
P	Output the m+1st through the nth characters.
Do not append a form feed character, and do
not change the buffer.
 n
_^P	Same as nP, but end up at the nth absolute page of the
file, rather than the nth page past the current page.
 
EF	Close the output file.
.ei hints

.!Insertion/Advanced insertion
.if doc
.st Insertion
.ei doc
.tp 10
.s2
.if help
 
14
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Insertion
.lm14
.endif doc
.ifnot doc
.c;^&Insertion\&
.endif doc
 
Itext$	Insert the text delimited by I and altmode.
 
_<Tab_>text$	Insert a tab followed by all the text up to the altmode.
.ei hints

.if doc
.st Advanced Insertion
.ei doc
.tp 10
.s2
.if help
 
15
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Advanced Insertion
.lm14
.endif doc
.ifnot doc
.c;^&Advanced Insertion\&
.endif doc
 
@
I/text/	Insert the text delimited by the arbitrary
character following I.
 n
I$	Insert the character with ASCII value n
(decimal).
 n
_\	Insert the ASCII representation of the
decimal integer n.
 n
_\_\	Insert the ASCII representation of the
octal integer n.
 
_^V	In an insert string, translate next character (if alphabetic)
to lower case.
 
_^V_^V	In an insert string, translate remaining alphabetic characters
to lower case.
 
_^W	In an insert string, translate next character (if alphabetic)
to upper case.
 
_^W_^W	In an insert string, translate remaining alphabetic characters
to upper case.
 
_^_^	In a insert string,
translate next character (if @, [, _\, ], _^,
or __) to "lower case" range.
 
_^R	In an insert string, accept next character as text.
 
_^Gi	Used inside an insert string to cause the contents
of Q-register i to be inserted into the string
at that point.
 
_^T	Used inside insert strings to cause all control
characters except _^R, _^T, and altmode to be
taken as text.  Nullified by a second _^T.
(Note: does not work unless the monitor command
"TTY RTCOMPATIBILITY" has been given).
.ei hints

.if doc
.st Deletion
.ei doc
.tp 10
.s2
.if help
 
16
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Deletion
.lm14
.endif doc
.ifnot doc
.c;^&Deletion\&
.endif doc
 n
D	Delete the n characters following the pointer
position.
 -n
D	Delete the n characters preceding the pointer
position.
 n
K	Delete all characters in the buffer from 
the current pointer position to the beginning
of the nth line from the pointer position.
 m
,n
K	Delete the m+1st through the nth characters.
.ei hints

.if doc
.st Immediate Type-out Commands
.ei doc
.tp 10
.s2
.if help
 
17
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Immediate Type-out Commands
.lm14
.endif doc
.ifnot doc
.c;^&Immediate Type-out Commands\&
.endif doc
.s;The following commands execute immediately
when typed as the first character following the
prompting "*".
 
_^J _<LF_>	When typed immediately after the prompt, moves the
pointer to the beginning of the next line
and types the line.
(Same as 1LT).
 
_^H	When typed immediately after the prompt, moves the pointer
to the beginning of the preceding line and
types the line.
(Same as -1LT).
 
_;	When typed immediately after the prompt, moves the pointer to the beginning of the
current line and types the line.
(Same as 0LT).
.ei hints

.if doc
.st Immediate video commands
.ei doc
.tp 10
.s2
.if help
 
18
.ei help
.ifnot hints
.if doc
.lm0
.hl1 Immediate Video commands
.lm14
.endif doc
.ifnot doc
.c;^&Immediate Video commands\&
.endif doc
TECO contains a different set of immediate commands if in "VIDEO"
mode (EVON$).  These commands are only valid as the first character of
a command line.
 
_^B	This command will cause the positioning command "+1R" to
be executed.
 
<SPACE>	This command will cause the positioning command "+1C" to
be executed.
 
_^U	This command will cause the cursor to move up to the line
above the current line.  The command that is executed is: "-1_^D".
 
_^D	This command will cause the cursor to move down to the
line below the current line.  The command that is executed is: "+1_^D".
 
_^J <LF>	This command will cause the positioning command "+1L"
to be executed.
 
_;	This command will cause the pointer to be positioned at the
beginning of the line.  The command that is executed is: "0L".
 
_^H	This command will cause the positioning command "-1L" to
be executed.
 
_^W	This command will cause the pointer to be advanced one
word.  This command is the same as the "+1FW" command.
.endif hints
.if doc
.st Type-out
.ei doc
.tp 10
.s2
.if help
 
19
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Type-out
.lm14
.endif doc
.ifnot doc
.c;^&Type-out\&
.endif doc
 n
T	Type all text in the buffer from the current
pointer position to the beginning of the nth
line from the pointer position.
 m
,n
T	Type the m+1st through the nth characters.
 n
V	Type all text within n lines from the current line.
Equivalent to (1-n)T nT.
 
Qi
=	Type the contents of Q-register i. (Numeric or text).
 n
=	Type the decimal integer n.
 n
==	Type the octal integer n.
.! {text}
=	Type the text on the terminal.
.ei hints

.if doc
.st Advanced Terminal I/O
.ei doc
.tp 10
.s2
.if help
 
20
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Advanced Terminal I/O
.lm14
.endif doc
.ifnot doc
.c;^&Advanced Terminal I/O\&
.endif doc
 m
,n
=	If m_<0, same as n=_; if m=0, don't output a CRLF after the
number_; if m_>0, output the ASCII character whose value
is m after the number.
 1
ET	Set to literal typeout mode.
 2
ET	Set to image typeout mode.
 0
ET	Restore typeout mode to normal.
(Type control characters in up-arrow form, altmodes as dollar signs, etc.).
 0
EU	Flag lower case characters on typeout by preceding
them with a ' (standard unless "TTY LC" is in effect).
 1
EU	Flag upper case characters on typeout.
 -1
EU	No case flagging on typeout.
 -1
ES	Set automatic typeout after searches.
 n
ES (n_>0)	Set automatic typeout
.;after searches
and use the character with ASCII value n (decimal)
to show the position
of the pointer.
 0
ES	Set to no automatic typeout after searches.
 
_^Amessage_^A	Type the message enclosed.
 
_^L _<FF_>	Type a form feed.
 
_^T	Stop command execution, wait for the user to type a character,
and then take on the 
ASCII value (in decimal) of the character typed.
 
:m
,n
_^T	Extended _^T operations: TTCALLS and echo control.
.lit
:0^T 	INCHRW		:1,8^T	CCL flag
:n,1^T	OUTCHR n	:9^T	CLRBFI
:2^T	INCHRS		:10^T	CLRBFO
:4^T	INCHWL		:11^T	SKPINC
:5^T	INCHSL		:12^T	SKPINL
:6^T	GETLCH		:n,13^T	IONEOU n
:n,7^T	SETLCH n	:-1^T	ECHO OFF
:8^T	RESCAN 1	:-2^T	ECHO ON
.end lit
.s2
.ei hints

.if doc
.st Searching
.ei doc
.tp 10
.s2
.if help
 
21
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Searching
.lm14
.endif doc
.ifnot doc
.c;^&Searching\&
.endif doc
.s;(Note: the buffer pointer is left unchanged when a search fails
unless the search caused a new page to be read into the buffer).
 n
Stext$	Search for the nth occurrence (following the
pointer) of the text delimited by S and
altmode, but do not go beyond the end of
the current page.  If n_<0, search backwards.
 m
,n
Stext$	Same as S, but search only between pointer positions
m and n. If m_>n, search backwards.
 n
FSoldtext$newtext$
.br;Search for the nth occurrence (following the
pointer) of the first text string and replace
it with the second text string. Do not go
beyond the end of the current page.
 n
Ntext$	Equivalent to nStext$ except that if the
text is not found on the current page, pages
are input and output until it is found.
 n
FNoldtext$newtext$
.br;Equivalent to FS except that if
the text is not found on the current page,
pages are input and output until it is 
found.
 n
FKtext$	Search for the nth occurrence of the text and delete the
text.  This is the same as FStext$$.
 n
FDtext$	Search for nth occurrence of text and delete everything from the current
pointer position to the end of text.
 n
FW	Search for the nth word after the pointer.  If n is zero then
the pointer is moved to the beginning of the current word.
.ei hints
.if doc
.st Advanced Searching
.ei doc
.tp 10
.s2
.if help
 
22
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Advanced Searching
.lm14
.endif doc
.ifnot doc
.c;^&Advanced Searching\&
.endif doc
 n
__text$	Equivalent to nNtext$ except that it does
input only, no output.
 
:n
Stext$	Equivalent to nStext$ except that it returns
a value of -1 if the search succeeds or 0 if
it fails instead of an error message. The _:
command can also be used with FS, N, FN, 
FD, and __.
 
@n
S/text/	Equivalent to nStext$ except that the text
is delimited by the arbitrary character 
following the S. The @ command may also
be used with FS, N, FN, FD, and __.
 0
_^X	Reset search mode to accept either case.
 n
_^X (n_#0)	Set search mode to "exact" mode.
 
_^V	In a search string, translate next character (if alphabetic)
to lower case.
 
_^V_^V	In a search string, translate remaining alphabetic characters
to lower case.
 
_^W	In a search string, translate next character (if alphabetic)
to upper case.
 
_^W_^W	In a search string, translate remaining alphabetic characters
to upper case.
 
_^_^	In a search string,
translate next character (if @, [, _\, ], _^,
or __) to "lower case" range.
 
_^R	In a search string, accept next character as text.
 
_^T	Used inside text arguments to cause all control
characters except _^R, _^T, and altmode to be
taken as text. Nullified by a second _^T.
(Requires "TTY RTCOMPATIBILITY" monitor command).
 
_^_\	Used inside search arguments to indicate
accept either case for following characters.
Nullified by a second _^_\.
 
_^X	When used inside a text argument, accept any
character at this position in the search string.
 
_^S	Accept any separator character at this position.
A separator is any character except a letter, digit, period,
dollar sign, or percent sign.
(Note: does not work unless the monitor command
"TTY NO PAGE" has been given).
 
_^Na	Accept any character except the arbitrary
character a following _^N.
 
_^Q	Take the next character in the search string
literally, even if it is a control character.
(Note: does not work unless the monitor command
"TTY NO PAGE" has been given).
 
_^Gi	Substitute the contents of Q-reg i into the text 
string at this point.
 
_^EA	Accept any alphabetic character as a match.
 
_^EV	Accept any lower case alphabetic character
as a match.
 
_^EW	Accept any upper case alphabetic character
as a match.
 
_^ED	Accept any digit as a match.
 
_^EL	Accept any end-of-line character as a match.
 
_^ES	Accept any string of spaces and/or tabs
as a match.
 
_^E_<nnn_>	Accept the ASCII character whose octal
value is nnn as a match.
 
_^E[a,b,c...]	Accept any one of the characters in the
brackets as a match.
.ei hints

.if doc
.st Q-registers
.ei doc
.tp 10
.s2
.if help
 
23
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Q-Registers
.lm14
.endif doc
.ifnot doc
.c;^&Q-Registers\&
.endif doc
 n
Ui	Store the integer n in Q-register i.
 m
,n
Ui	Store the integer n in Q-register i and return
the value of m.  (For example, the command m,nUiUj is equivalent to nUi mUj).
 
Qi	Return the value stored in Q-register i
(for use as a numeric argument to another command).
 n
%i	Increment the value in Q-register i by the value of n.  If
n is omitted then the default of one is used.
 n
Xi	Store, in Q-register i, all characters from
the current pointer position to the beginning
of the nth line from the pointer.
 m
,n
Xi	Store the m+1st through nth characters in
Q-register i.
 
Gi	Insert a copy of the text in Q-register i at the current
pointer position.
 m
,n
Mi	Execute the text in Q-register i as a command
string.  The arguments m,n are optional, and are passed to the first command
of the string.
 m
,n
Wi	Execute the text in Q-register i as a command
string by a "jump" rather than a "call".
 
[i	Push the current contents of Q-register i onto 
the Q-register pushdown list.
 n
[i	Equivalent to [i nUi.
 m
,n
[i	Equivlent to [i m,nUi.
 
]i	Pop the last stored entry from the Q-register
pushdown list into Q-register i.
 
*i	If typed immediately after the prompt,  save the
preceding command string in Q-register i.
 EP(q-name)filespec$
.br;Read a file and put it into a Q-register.
The (q-name) is optional and will default to *.
 EI(q-name)filespec$
.br;Read a file, put it into a Q-reg, and execute it as an
TECO macro. The q-name will default as above.
 EQ(q-name)filespec$
.br;Write the text from Q-register q-name into the file. If (q-name)
is absent q-register * is used.
.ei hints
.if doc
.st Predefined Q-Registers
.ei doc
.tp 10
.s2
.if help
 
24
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Predefined Q-Registers
.lm14
.endif doc
.ifnot doc
.c;^&Predefined Q-Registers\&
.endif doc
.s;The following are predefined Q-Registers that serve some special purpose.
 
AUTO-BUFFER	This Q-Register is executed after ever N commands,
where N is the number that is contained in the AUTO-COUNT Q-Register.
 
AUTO-COUNT	This Q-Register contains a value.  If this Q-register contains
a positive value, n, then the Q-Register AUTO-BUFFER will be executed after n
command lines are executed.  (One command line is until the two altmodes).
 
COMMAND-BUFFER	This is the Q-Register that all TECO commands are
stored in as they are typed in.  If this Q-Register is displayed on the
screen by an n,mE$(COMMAND-BUFFER), then the commands typed will echo on
those lines.
 
ERROR-TEXT	This Q-register contains the text of the last error message.
 
TEXT-BUFFER	This is the Q-Register that contains the text that
is currently being edited.
.ei hints
.if doc
.st Iteration Commands
.ei doc
.tp 10
.s2
.if help
 
25
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Iteration Commands
.lm14
.endif doc
.ifnot doc
.c;^&Iteration Commands\&
.endif doc
 n
_<commands_
>	Perform the enclosed command string n times.
 
_;	Jump out of the current iteration field, if the
last search executed failed.
 n
;	If n_>=0, jump out of the current iteration field.
.ei hints
.if doc
.st Flow Control
.ei doc
.tp 10
.s2
.if help
 
26
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Flow Control
.lm14
.endif doc
.ifnot doc
.c;^&Flow Control\&
.endif doc
 
_!tag_!	Define a label in the command string with
the name "tag".
 
Otag$	Jump to the label defined by _!tag_!. WARNING: Don't use O
to jump into or out of iteration brackets <..>.
.ei hints
.if doc
.st Conditional Execution Commands
.ei doc
.tp 10
.s2
.if help
 
27
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Conditional Execution Commands
.lm14
.endif doc
.ifnot doc
.c;^&Conditional Execution Commands\&
.endif doc
.s;These commands are of the form
.s
.c;n"x.......'
.s
If the numeric value of n satisfies condition x, all the commands between
"x and ' are executed; execution falls through the apostrophe
unless the command string contains a jump.
If n does not satisfy x,
execution resumes with the command following the '.
 n
"Ecommands
'	If n=0, execute the commands specified
between "E and '_; otherwise, skip to the '.
 n
"Ncommands
'	If n_#0, execute the enclosed commands.
 n
"Lcommands
'	If n_<0, execute the enclosed commands.
 n
"Gcommands
'	If n_>0, execute the enclosed commands.
 n
"Ccommands
'	If n is the ASCII value (decimal) of a symbol
constituent character (a letter, digit, period, percent sign, or dollar sign),
execute the enclosed
commands.
 n
"Dcommands
'	If n is a digit execute the enclosed commands.
 n
"Acommands
'	If n is alphabetic, execute the enclosed
commands.
 n
"Vcommands
'	If n is lower case alphabetic, execute the
enclosed commands.
 n
"Wcommands
'	If n is upper case alphabetic, execute the
enclosed commands.
 n
"Tcommands
'	If n is true, execute the enclosed commands.
 n
"Fcommands
'	If n is false, execute the enclosed commands.
 n
"Scommands
'	If n is "successful", execute the enclosed
commands.
 n
"Ucommands
'	If n is "unsuccessful", execute the enclosed
commands.
.ei hints

.if doc
.st Special Numeric Values
.ei doc
.tp 10
.s2
.if help
 
28
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Special Numeric Values
.lm14
.endif doc
.ifnot doc
.c;^&Special Numeric Values\&
.endif doc
 n
A	The ASCII value (decimal) of the character
n positions to the right of the pointer. 0A gives the
character to the left of the pointer, -nA gives the character
n+1 positions to the left of the pointer.  If the position lies
outside the buffer boundaries, return 0.
 m
,n
A	Same as nA, but returns m if the position is outside the
buffer boundaries.
 
_^E	The form feed flag. Equals 0 if no form feed
character was read on the last input, -1
otherwise.
 
_^N	The end-of-file flag; equals -1 if end of input
file seen on last input. Otherwise equals 0.
 
_^F	Decimal value of the console data switches.
 -1
_^F	TTY number (+ 200000 octal) of this job.
 n
_^F	TTY number (+ 200000 octal) of job n.
 
_^H	The time of day in 60th's of a second.
Must be typed as up-arrow H.
 
ET	The value of the type-out mode switch. (0=normal, 1=literal, 2=image).
 
ES	The value of the autotype after successful searches
switch. -1 = auto typeout, 0 = no typeout, n>0 = autotype using
ASCII character n to show position of pointer.
 
_^X	Value of the search mode flag. (0=either case
mode, -1=exact mode).
 
EU	The value of the EU flag.
+1 = flag upper case characters.
0 = flag lower case characters.
-1 = no case flagging on typeout.
 
EO	The value of the EO flag. 1 = version 21A;
2 = versions 22, 24; 3 = TECO 123 and 124; 4 = TECO 200 without string
arguments; 5 = TECO 200 with string arguments and FC command processing.
 
EH	The value of the EH flag. 1 = code only,
2 = code plus one line, 3 = all of error message.
 
_^_^x	The ASCII value (decimal)
of the arbitrary character x following _^_^.
 
_\	The decimal value of the digit
string following the pointer.
Leaves pointer at right end of the digit string.
 
_\_\	The octal value of the digit
string following the pointer.
Leaves pointer at right end of the digit string.
 
_^G	Returns job number.
 n
_^G	Monitor PEEK UUO, using n as an argument.
 m
,n
_^G	Monitor GETTAB call, using m,n as arguments.
.ei hints

.if doc
.st Aids
.ei doc
.tp 10
.s2
.if help
 
30
.ei help
.ifnot hints
.if doc
.lm0
.HL1 Aids
.lm14
.else doc
.c;^&Aids\&
.endif doc
 
:	Enables error control.  Many commands (especially search
and file commands), if preceded by a :, will not cause
an error message if they fail.  The _: modifier will
cause the command to return a value of 0 if it fails,
-1 if it is successful.
Exception: :nA command uses _: to distinguish it from nA.
 
EC	Perform a garbage collection
and reduce the amount of core as much as possible.
If preceded by a negative argument, EC will do a garbage
collection and not print the [nP core] (or [nK core]) message.
If EC is preceded by a positive argument it will expand the low
segment to n pages where n is the arg.

 
/	When used after an error message, this causes
a more detailed explanation of the error to be
typed.
 *i	When used at the beginning of a command string,
this causes the entire previous command string
(minus one of the two concluding altmodes)
to be moved into Q-register i.
 
?	When used after an error message, this causes
the offending command to be typed out (with
a few of the commands preceding it).
 
?	Enter trace mode. A second _? command
takes TECO out of trace mode.
 _<DEL_>	
Rubout last character typed in the command
string.
 
_^H	If a CRT has been specified, erases and backs over 
previously typed character.  (Must be typed as a control character.)
 
_^G_^G	Erase the entire command string.
 
_^G _<space_>	Retype current line of command string.
 
_^G.	Retype entire command.
 
_^U	Erase everything typed in back to the last CRLF.
(Must be typed as a control character.)
 0
EO	Restore the EO value to standard (5).
 n
EO (n not 0)	Set the EO value to n.
 1
EH	Type only code part of error messages.
 2
EH	Type error code plus one line.
 3
EH	Type all three parts of error.
 0
EH	Equivalent to 2EH.
 
_^V	Set prevailing mode for insertions and searches to lower case.
 
_^W	Set prevailing mode for insertions and searches to upper case.
.ei hints

.ifnot help
.ifnot card
.lm0
.p 5,1,2
.if doc
.pg
.st Hints
.ei doc
.tp 10
.if hints
.ps9999,70
.rm 70
.nhd
.C;^&TECO Hints\&
.ei hints
.if doc
.HL1 Hints
.else doc
.c;^&Hints\&
.endif doc
.if hints
 This file contains little known features and general hints to
make living with TECO easier and more efficient.
 Note that this file can be examined at any time during a TECO
session (without affecting the text buffer, pointer, etc.) by the
command EPfilename.ext$Q*=$$", which stores the contents of filename.ext
into Q-register *, and then types them.
.endif hints
.require "TECOHI.NTS"
.EI CARD
.EI HELP