Google
 

Trailing-Edge - PDP-10 Archives - decuslib10-03 - 43,50312/mants5.rnh
There are no other files named mants5.rnh in the archive.
.SPACING 1
.TAB STOPS 8 16 24 32 40 48 56
.PAPER SIZE 60 72
.NOFILL
		^THE ^^MANTIS\\ ^DEBUGGER
.SKIP 2
^^MANTIS\\ IS USED TO DEBUG ^^FORTRAN IV(F40/FOROTS)\\ PROGRAMS.
^AN ILLUSTRATIVE TABLE OF CONTENTS FOR THE ^USER'S ^MANUAL FOLLOWS.
------_> ^GENERALLY YOU START ^^MANTIS\\ BY
^^.DEB/LO\\  FILENAMES		[SEE P.2]
		^^MANTIS\\ READS EACH COMMAND AFTER YOU TYPE CARRIAGE-
		RETURN AND WILL RESPOND WITH '*' WHEN DONE.
------_> ^AUTOMATIC ACTION COMMANDS: (^PREFIX WITH ^^STOP\\ TO ALSO HALT
		EXECUTION.  ^OTHER COMMANDS MAY BE ATTACHED DELIMITED
		BY SEMICOLONS. [P.3])
^^AT\\ X		^NOTIFY EACH TIME BEFORE STATEMENT EXECUTED. [P.1,2,3]
^^AT\\ X,N		^EVERY NTH TIME.
^^ON CALL\\ X	^NOTIFY BEFORE ENTERING ROUTINE (AFTER PROLOGUE). [P.3]
^^BEFORE\\ X	^NOTIFY BEFORE RETURN FROM ROUTINE. [P.3]
^^ON\\ X		^NOTIFY WHEN ASSIGNMENT OR INPUT STMT MODIFIES
		VARIABLE IN PARTICULAR ROUTINE. [P.3]
^^ON\\ X RELATION CONSTANT    ^NOTIFY WHEN CONDITION (^^.EQ..NE.
			.LT..GT..LE..GE.\\) IS TRUE FOR A NEW VALUE.
^^ON\\-COMMAND ^^AT\\-OR-^^BETWEEN\\    ^NOTIFY FOR ONLY ONE OR SEVERAL STMTS. [P.3]
.SKIP
------_> ^TYPE ^^GO\\ TO START OR RESUME PROGRAM EXECUTION.
------_> ^JUST TYPE RETURN TO FIND OUT WHERE EXECUTION WAS HALTED.
------_> ^THESE COMMANDS MAY BE ATTACHED TO THE ABOVE AUTO ACTION CMDS.
^^GO\\ X		^RESUME EXECUTION AT A STATEMENT. [P.1,3]
^^TYPE\\ X		^DISPLAY THE NUMERIC VALUE OF THE LOCATION(S). [P.1,3]
^^TY J IN TEXT, M(4) IN OCTAL\\	^DISPLAY ^J AS CHARACTERS AND ^M(4)
				AS AN OCTAL NUMBER.
V = X		^CHANGE THE VALUE OF ANY VARIABLE V. [P.1,3]
^^J = 'HELLO'\\	(CHARACTER DATA)
^K = "577	(OCTAL DATA)
^^LOG = F\\		(LOGICAL DATA)
^^KILL\\ X		^REVOKE AN ^^AT, ONCALL, BEFORE\\, OR ^^ON\\ CMD. [P.4]
------_> ^TYPE ^^KILL\\ TO REVOKE ALL AUTO ACTION CMDS AND ATTACHED CMDS.
.SKIP
------_> ^TYPE ^^SUBCHECK\\ TO AUTOMATICALLY CHECK THE VALUES OF ALL
			ARRAY SUBSCRIPTS. [P.5]
^^SUBCHECK SUBR/\\	^CHECK ALL ARRAYS IN ROUTINE ^^SUBR\\.
^^SUBCHECK MAIN/Y AT 110\\    ^CHECK THE REFERENCE TO ARRAY ^Y IN THE
		MAIN PROGRAM AT STMT NUMBER 110.
^^SUBCHECK MAIN/,BETWEEN 50+3 AND 70\\    ^CHECK ALL ARRAYS IN THE MAIN
		PROGRAM BETWEEN THE SPECIFIED STATEMENTS.
^^STOP SUBCHECK\\	^STOP ALL SUBSCRIPT CHECKING.
.SKIP
------_> ^TYPE ^^HISTORY\\ TO DISPLAY LOG OF ROUTINE CALLS(MOST RECENT FIRST).
------_> ^TYPE ^^TRACE\\ TO INTERNALLY LOG ALL EXCEPTIONS TO SEQUENTIAL FLOW.
^^TRACE OUTPUT\\	^DISPLAY FLOW AS IT OCCURS.	[SEE P.5]
^^TRACE PAUSE\\	^STOP AFTER EACH ^^TRACE\\ DISPLAY.
^^STOP TRACE\\	^REVOKE ^^TRACE\\ COMMAND.
.SKIP
------_> ^TO INTERRUPT EXECUTION: TYPE CONTROL-^C ONCE OR TWICE TO GET
_^^C_^^C		THE MONITOR DOT, THEN TYPE ^^REENTER\\.  ^IF ONLY ONE 
^^.REE\\		CONTROL-^C WAS NEEDED THEN YOUR PROGRAM IS REQUESTING
		THAT YOU TYPE DATA FOR IT. [P.8]
.SKIP
[^SEE P.6 FOR RECOVERY FROM COMMON ERRORS.]
.PAGE
#
------_> ^TO RESTART ENTIRE PROGRAM FIRST REPOSITION ANY MAGTAPES
^^RESTART\\		AND THEN YOU INITIALIZE ANY VARIABLES AS NECESSARY.
------_> ^TYPE ^^EXIT\\ TO RETURN TO MONITOR AND CLOSE ^^USE\\ FILE.
^^ENDFILE\\ _#N	^MAGTAPE COMMANDS LIKE THIS INCLUDE ^^REWIND, UNLOAD,
		BACKSPACE,\\ AND ^^SKIPRECORD\\.
^^USE\\ FILENAME	^PUT OUTPUT FROM THE DEBUGGER ONTO DISK USING UNIT 24.
^^USE TTY\\		^DIRECT DISPLAYS FROM DEBUGGER TO THE TELETYPE. [P.6,8]
.SKIP
------_> ^TO SPECIFY A POSITION IN PROGRAM:	[SEE P.2]
10		^STATEMENT NUMBER 10 IN THE ROUTINE THAT WAS EXECUTING.
^^SUBR/20\\		^STMT NUMBER 20 IN ROUTINE ^^SUBR\\.
		(^TYPE ^^MAIN/\\ TO REFER TO MAIN PROGRAM.)
^^SUBR/+1\\		^FIRST EXECUTABLE STMT IN ROUTINE ^^SUBR\\.
75-5		^FIFTH EXECUTABLE STMT BEFORE 75 IN CURRENT ROUTINE.
^^AT\\ X		^THIS PHRASE USED AFTER AUTOMATIC ACTION COMMAND.
^^BETWEEN\\ X ^^AND\\ Y    ^THIS PHRASE SPECIFIES SEVERAL STMTS OF A ROUTINE.
			(^DOES NOT INCLUDE LAST STMT.)
.SKIP
------_> ^TO SPECIFY DATA LOCATION(S):	[SEE P.3,2]
^^WALL\\		^VARIABLE ^^WALL\\ IN THE ROUTINE THAT WAS EXECUTING.
^^DOG/B\\		^VARIABLE ^B IN ROUTINE ^^DOG\\.
^^MOON(7)\\		^SEVENTH ELEMENT IN VECTOR ^^MOON\\.
		(^A VARIABLE MAY NOT BE USED AS A SUBSCRIPT.)
^^MOON\\(*)		^ALL ELEMENTS IN VECTOR ^^MOON\\. (^THIS NOTATION MUST BE
		USED ALONE IN A SINGLE DISPLAY OR VALUE-CHANGE CMD.)
^Z(2,*)		^ALL ELEMENTS IN SECOND ROW OF ARRAY ^Z.
.SKIP
[^SEE P.10 FOR THE COMMAND SYNTAX.]
[^SEE P.11 FOR SELECTED MESSAGES THAT ARE DISPLAYED BY ^^MANTIS\\.]
[^SEE P.1,7,8 FOR EXAMPLE SESSIONS.]