.\"output part or all of a file
.DT
cat
Discworld driver help
cat

Name
.SI 5
cat() - output part or all of a file

.EI
Synopsis
.SI 5
int varargs cat( string path, int start, int num );

.EI
Description
.SP 5 5
List the file found at <path>. It is not legal to have '.' or spaces
in the path. This commands is normally connected to the cat command
that wizards have. It is also used by the help command. The optional
arguments <start> and <num> are the starting line number, and number of lines.
If they are not given, the whole file is printed from the beginning.

The total number lines will not exceed a system limit, which normally
is 40 lines.

cat() returns 1 if success, 0 if no such file or no such lines.

.EP
See also
.SI 5
ls(3), file_size(3), read_file(3)
.EI
