[unix-history] / usr / src / cmd / apl / documents / apl.1

.th APL I 7/10/78
.sh NAME
apl  \*-  The UCSF APL interpreter
.sh SYNOPSIS
.bd apl
.sh DESCRIPTION
The UCSF APL interpreter contains all the APL 360 operators
plus execute (epsilon), scan, and relational character operators.
The maximum workspace size is about 50,000 bytes.
.s3
Function definition is not what you would expect. Functions are
created and modified with the system editor. Type `)EDIT fname'
or `)EX fname' to creat or modify a function. Type `)READ
fname' if it exists and doesn't need editing.
.s3
The following I-beams are recognized by APL:
.in +.6i
.s3
1iF		Open F for reading.
.s3
2iF		Create F for writing.
.s3
3iF		Append to F.
.s3
1i0, 2i0, 3i0	Close the named channel.
.in
.s3
Only one read channel and
one write channel may be open simultaneously. When a file is open
for reading, references to the quad or quote-quad variable are
actually references to the named file. When open for writing,
assignments to the quad variable are written to the file.
.s3
.in +.6i
10iC	Send command C to the shell.
.in
The command will be executed
as if it were typed at a UNIX terminal. This is equivalent to
the `!' feature of the editor.
.s3
Monadic I-beam functions are: 20 for the time of day, 21
to return CPU time used, 22 to return WS free in bytes,
24 to return the starting time, 25 to return the date,
28 to return the starting date, 29 to read the index
origin, 30 to read the terminal width, 31 to read the
printing precision (or `digits'), and 32 to
run the shell.
.sh BUGS
No trace function or state indicator.
.s3
No `)WSID' command. The existing system commands take
only one argument.
.s3
A `)WRITE fname' command is needed to get at functions which
exist only in workspaces.
Commit	Line	Data
a15aebc9 KT	1	.th APL I 7/10/78
	2	.sh NAME
	3	apl \*- The UCSF APL interpreter
	4	.sh SYNOPSIS
	5	.bd apl
	6	.sh DESCRIPTION
	7	The UCSF APL interpreter contains all the APL 360 operators
	8	plus execute (epsilon), scan, and relational character operators.
	9	The maximum workspace size is about 50,000 bytes.
	10	.s3
	11	Function definition is not what you would expect. Functions are
	12	created and modified with the system editor. Type `)EDIT fname'
	13	or `)EX fname' to creat or modify a function. Type `)READ
	14	fname' if it exists and doesn't need editing.
	15	.s3
	16	The following I-beams are recognized by APL:
	17	.in +.6i
	18	.s3
	19	1iF Open F for reading.
	20	.s3
	21	2iF Create F for writing.
	22	.s3
	23	3iF Append to F.
	24	.s3
	25	1i0, 2i0, 3i0 Close the named channel.
	26	.in
	27	.s3
	28	Only one read channel and
	29	one write channel may be open simultaneously. When a file is open
	30	for reading, references to the quad or quote-quad variable are
	31	actually references to the named file. When open for writing,
	32	assignments to the quad variable are written to the file.
	33	.s3
	34	.in +.6i
	35	10iC Send command C to the shell.
	36	.in
	37	The command will be executed
	38	as if it were typed at a UNIX terminal. This is equivalent to
	39	the `!' feature of the editor.
	40	.s3
	41	Monadic I-beam functions are: 20 for the time of day, 21
	42	to return CPU time used, 22 to return WS free in bytes,
	43	24 to return the starting time, 25 to return the date,
	44	28 to return the starting date, 29 to read the index
	45	origin, 30 to read the terminal width, 31 to read the
	46	printing precision (or `digits'), and 32 to
	47	run the shell.
	48	.sh BUGS
	49	No trace function or state indicator.
	50	.s3
	51	No `)WSID' command. The existing system commands take
	52	only one argument.
	53	.s3
	54	A `)WRITE fname' command is needed to get at functions which
	55	exist only in workspaces.