⟦9bf83c268⟧

TextFile

%*+-------------------------------------+-----------------+---------------------+
!           Cursor movement           !      Block      !       Various       !
+-------------------------------------+-----------------+---------------------+
! ^S    Left char   ^D    Right char  ! ^K^B  Begin     ! ^J    Help          !
! ^A    Left word   ^F    Right word  ! ^K^K  End       ! ^K^D  Quit editor   !
! ^Q^S  Start line  ^Q^D  End line    ! ^K^Y  Delete    ! ^K^X  Exit editor   !
! ^E    Up line     ^X    Down line   ! ^K^C  Copy      ! ^V    INSERT on/off !
! ^Q^E  Top line    ^Q^X  Bottom line ! ^K^V  Move      ! ^Z    AUTO on/off   !
! ^R    Up page     ^C    Down page   ! ^K^P  Print     ! ^B    TABS on/off   !
! ^Q^R  Start text  ^Q^C  End text    ! ^K^H  Del marks ! ^W    ADJUST on/off !
+-------------------------------------+-----------------+---------------------+
!               Delete                !      Edit       !       Search        !
+-------------------------------------+-----------    Invoke the editor.
COMPILE   Compile the source text.      RUN       Run current program.
PROGRAM   Compile to program file.      OBJECT    Compile into object file.
FIND      Find a run-time error.        WHERE     Restart editor.
DIR       Display disk directory.       USE       Set default drive and user.
MEMORY    Display memory size.          ZAP       Zap (delete) source text.
HELP      Display help screens.         QUIT      Return to CP/M.

Note that all commands may be abbreviated to their first letter.

For further help on the commands above, enter 'HELP' or 'H' followed by the
command name (or the first character of it).

%ECOMPAS ON-LINE HELP: The EDIT command.

The EDIT command invokes the on-screen editor. Once you are in the editor, a
list of editor commands may be displayed by pressing CTRL/J.

%LCOMPAS ON-LINE HELP: The LOAD command.

The LOAD command is used to load a source text into memory. The command line
format is:

        LOAD <filename>

If the file type errors are re-
ported, insert another disk, log it in using the USE command, any try SAVE
again.

%NCOMPAS ON-LINE HELP: The NAME command.

The NAME command is used to change the current file name. The current file
name is used by SAVE, PROGRAM, and OBJECT when a file name is not explicitly
stated. The command line format is:

        NAME <filename>

If <filename> is omitted entirely, NAME displays the current file name instead
of changing it. If the file type is omitted, it defaults to '.PAS'.

The current file name is set to 'WORK.PAS' when COMPAS is cold-started and
when a ZAP command is issued.

%CCOMPAS ON-LINE HELP: The COMPILE command.

When the compiler is invoked from a COMPILE command, the object code is stored
directly into memory in succession of the source text.

Following a successful compilation, you are informed of the size of the code
segment, the data segment, and free memory (the stack segment):

        Code: rrrrrr bytes (aaaa paragraphs)
        Data: ssssss b the program into a command file on a
disk. The command line formats is:

        PROGRAM <filename>,<ssegmin>,<ssegmax>,<csegmin>,<dsegmin>

If <filename> is omitted, the current file name is used, with its type changed
to '.CMD'. The file type defaults to '.CMD'. <ssegmin>, <ssegmax>, <csegmin>,
and <dsegmin> are hex numbers (up to four hex digits). Any one of the four hex
parameters may be omitted, for instance 'PROGRAM TEST,800' (only <ssegmin>) or
'PROGRAM TEST,,,CD8,12E4' (only <csegmin> and <dsegmin>).

<ssegmin> and <ssegmax> specify the minimum and maximum sizes (in paragrahps)
of the stack segment. <ssegmin> defaults to 100 hex (4K bytes), and <ssegmax>
defaults to the value of <ssegmin>. <csegmin> and <dsegmin> specify the mini-
mum sizes (in paragrahps) of the code and data segments. They default to the
lowest possible values. They may never be larger than hex FFF (64K bytes), and
usually they are only specified for programs that will chain to other programs
with larger code and/o------+---------------------+
! DEL   Char left   ^G    Char right  ! RETN  New line  ! ^Q^F  Find string   !
! ^QDEL Start line  ^Q^Y  End line    ! ^I    Tabulate  ! ^Q^A  Find/replace  !
! ^Y    Line all    ^T    Word right  ! ^N    Insert CR ! ^L    Find next     !
+--------------------------------------+-----------------+--------------------+
! Find/replace options:  G = Global (all text), N = Replace without prompting !
+-----------------------------------------------------------------------------+
! ADJUST mode: Use ^S and ^D to adjust then ^E or ^X to repeat above or below !
+-----------------------------------------------------------------------------+

% COMPAS ON-LINE HELP: The command mode

COMPAS prompts by printing '>>'. Each time this prompt appears, COMPAS is
ready to accept and process a command line. The following commands are
available in the command mode.

LOAD      Load a source text.           SAVE      Save the source text.
NAME      Set current file name.        EDIT  is omitted, it defaults to '.PAS'. The current file name is
set to <filename>. When a file is loaded, it is appended to the end of the
source text already in memory. If the file specified does not exist, COMPAS
displays 'No such file'. If loading the file would overflow the memory buffer,
COMPAS displays 'File too big'. For both errors, the text already in memory
remains unchanged.

%SCOMPAS ON-LINE HELP: The SAVE command.

The SAVE command is used to save the text in memory in a disk file. The com-
mand line format is:

        SAVE <filename>

If <filename> is omitted entirely, it defaults to the current file name set by
LOAD or NAME. If the file type is omitted, it defaults to '.PAS'. If a file of
the same name and type exists on the disk specified, its type is changed to
'.BAK' before the new file is created. If the disk directory is full, COMPAS
displays 'Directory is full'. If there is not enough room on the disk to cre-
ate a new file, COMPAS displays 'Disk is full'. If one of these ytes (bbbb paragraphs)
        Free: tttttt bytes (cccc paragraphs)

The numbers displayed in parentheses are the paragraph sizes (in hex) of each
area in (one paragraph corresponds to 16 bytes).

Note that whenever you invoke the editor, the object code is erased.

%RCOMPAS ON-LINE HELP: The RUN command.

The RUN command is used to execute a program. If no program code is present,
the compiler is invoked to compile the program (see 'HELP COMPILE' screen).
Assuming a successful compilation, or if the object code was already present,
the program is started. When it ends, it automatically transfers control to
the command mode.

If a run time error occurs, the program will terminate displaying a run time
error message, for instance:

        EXECUTION ERROR 04 AT PC=254E
        Program terminated

You may then use the FIND command to locate the statement that caused the
error (see 'HELP FIND' screen).

%PCOMPAS ON-LINE HELP: The PROGRAM command.

The PROGRAM command is used to compiler data segments. On compiling the program, COMPAS writes
a copy of the run-time package into the command file. Once compiled, the prog-
ram can be executed from CP/M-86 simply by typing its name.

%OCOMPAS ON-LINE HELP: The OBJECT command.

The OBJECT command produces an object file which contains the compiled program
code only (i.e. without the run-time package and the command file header). The
command line format is:

        OBJECT <filename>

If <filename> is omitted, the current file name is used, with its type changed
to '.CHN' (short for chain). The file type defaults to '.CHN'. Object (chain)
files may only be activated through the chain procedure of COMPAS Pascal. For
further details on program chaining, please refer to the COMPAS Pascal Prog-
ramming Manual.

%FCOMPAS ON-LINE HELP: The FIND command.

The FIND command is used to locate a statement in the source text which cor-
responds to an offset address in the object code. The command line format is:

        FIND <offset>

where <offset> is the offset address of the statement to be located. The off-
set address must be specified in hex (up to four hex digits). <offset> may be
omitted, in which case it defaults to the offset address of the last run time
error. Thus, to locate the statement that caused a run time error, simply en-
ter 'FIND'.

If the offset address is found, the compiler stops and displays 'Target ad-
dress found' followed by 'Press <RETURN> to edit or <ESC> to abort. When you
press RETURN, the editor is invoked, and the cursor is placed at or just after
the relevant section. If the offset is out of range, the compiler outputs
'Target address not found'.

%WCOMPAS ON-LINE HELP: The WHERE command.

The WHERE command invokes the editor, and moves the cursor to a specific posi-
tion in the text. The command line format is:

        WHERE <offset>

where <offset> is a hex number specifying the offset address of the spot to be
located. Whenever you leave the editor, the offset address of the cursving only a drive iden-
tifier and a colon, then all files on that drive are listed. If <afn> is omit-
ted entirely, then all files of the currently logged drive are listed.

Note that system files are not displayed.

%UCOMPAS ON-LINE HELP: The USE command.

The USE command is used to log in new disks, and to change the currently log-
ged drive and user number. The command line format is:

        USE <drive><user>

where <drive> is a drive identifier (A-P), and <user> is a user number (0-15).
If <drive> is specified, the currently logged drive is changed, and if <user>
is specified, the current user number is changed. The USE command ends by dis-
playing the currently logged drive and user number.

Whenever a disk is changed in one of the drives, a USE command should be is-
sued to log in that disk. Otherwise, CP/M will report an R/O error if you try
to write to that disk.

%MCOMPAS ON-LINE HELP: The MEMORY command.

The MEMORY command displays the size of free memory:

        Free&Ddefined
&E expected
&Ffile
&H are not allowed here
&IIllegal 
&J identifier
&NExpression is not of type 
&Oonstant
&Ptype
&RInteger or real 
&SUnknown identifier or syntax error in 
&Tstatement
&UUnknown or illegal 
&Vvariable
&Xxpression
&YType mismatch in 
&ZVariables of this type cannot be 
01'.'&E
02BEGIN&E
03&Ifunction result &P
04Duplicate&J
05Absolute &Vs are not allowed in records
06Type&J&E
07Files may only be &V parameters
08&U&P
09END&E
10Set base &P out of range
11File components may not be &Fs
12&Istring length
13&Isubrange base &P
14'..'&E
15&Ysubrange bounds
16Lower bound greater than upper bound
17&Usimple &P
18Simple &P&E
19Unknown pointer &P in &P definitions
20Un&D label in &T part
21&IGOTO in &T part
22Label already &D
23THEN&E
24DO&E
25&U&V&J
26Variable &P is not a simple &P
27&YFOR &T e&Xs
28TO or DOWNTO&E
29C&O and CASE selector &P does not agree
30END or OTHERWISE&E
31Unknown label
32Too many nested WITH &Ts
33Record &V&E
34&U&V
35&Irocedure or function not properly &D
94Error in CODE &T
95&Iuse of AT specification
96Overlays not supported in direct mode
97Overlays cannot be forwarded
98PROCEDURE or FUNCTION&E
99Cannot create overlay &F
100Error in EXTERNAL &F
«eof»
DataMuseum.dk

CP/M

⟦9bf83c268⟧ TextFile

Derivation

TextFile
