Avoid informal use of 'you'
This commit is contained in:
parent
2291dff954
commit
fad1c30409
3 changed files with 21 additions and 20 deletions
|
@ -11,12 +11,12 @@ If these routines are used in Pascal programs, then the calling sequence
|
||||||
requires some attention.
|
requires some attention.
|
||||||
Some hints may be useful:
|
Some hints may be useful:
|
||||||
.IP -
|
.IP -
|
||||||
The c-option {$c+} allows you to declare zero-terminated string
|
The c-option {$c+} allows declaration of zero-terminated string
|
||||||
constants in Pascal like "/etc/passwd".
|
constants in Pascal like "/etc/passwd".
|
||||||
Moreover, the identifier \fIstring\fP is then defined as type identifier for
|
Moreover, the identifier \fIstring\fP is then defined as type identifier for
|
||||||
a pointer to these zero-terminated strings.
|
a pointer to these zero-terminated strings.
|
||||||
.IP -
|
.IP -
|
||||||
The d-option {$d+} allows you to use double precision integers (longs).
|
The d-option {$d+} allows the use of double precision integers (longs).
|
||||||
The lseek system call, for instance, needs a long argument and returns a long result.
|
The lseek system call, for instance, needs a long argument and returns a long result.
|
||||||
.IP -
|
.IP -
|
||||||
If the system call requires a pointer as argument use a \fIvar\fP parameter.
|
If the system call requires a pointer as argument use a \fIvar\fP parameter.
|
||||||
|
|
27
man/libpc.7
27
man/libpc.7
|
@ -114,13 +114,13 @@ the ASCII range (0..127) do not cause an error message.
|
||||||
Initialize a file for output on the diagnostic output stream (fd=2).
|
Initialize a file for output on the diagnostic output stream (fd=2).
|
||||||
Output is not buffered.
|
Output is not buffered.
|
||||||
.IP pcreat
|
.IP pcreat
|
||||||
The same as rewrite(f), except that you must provide the filename yourself.
|
The same as rewrite(f), except that the file name must be provided.
|
||||||
The name must be zero terminated. Only text files are allowed.
|
The name must be zero terminated. Only text files are allowed.
|
||||||
.IP popen
|
.IP popen
|
||||||
The same as reset(f), except that you must provide the filename yourself.
|
The same as reset(f), except that the file name must be provided.
|
||||||
The name must be zero terminated. Only text files are allowed.
|
The name must be zero terminated. Only text files are allowed.
|
||||||
.IP pclose
|
.IP pclose
|
||||||
Gives you the opportunity to close files hidden in records or arrays.
|
To close files hidden in records or arrays.
|
||||||
All other files are closed automatically.
|
All other files are closed automatically.
|
||||||
.PD
|
.PD
|
||||||
.PP
|
.PP
|
||||||
|
@ -129,7 +129,7 @@ String handling:
|
||||||
.RS
|
.RS
|
||||||
.IP strbuf 10
|
.IP strbuf 10
|
||||||
Type conversion from character array to string.
|
Type conversion from character array to string.
|
||||||
It is your own responsibility that the string is zero terminated.
|
It is the responsibility of the user that the string is zero terminated.
|
||||||
.PD 0
|
.PD 0
|
||||||
.IP strtobuf
|
.IP strtobuf
|
||||||
Copy string into buffer until the string terminating zero byte
|
Copy string into buffer until the string terminating zero byte
|
||||||
|
@ -151,11 +151,12 @@ string length, so this is a dangerous procedure.
|
||||||
.RE
|
.RE
|
||||||
Trap handling:
|
Trap handling:
|
||||||
.RS
|
.RS
|
||||||
These routines allow you to handle almost all
|
These routines allow for user-level handling off almost
|
||||||
the possible error situations yourself.
|
all possible error situations.
|
||||||
You may define your own trap handler, written in Pascal, instead of the
|
Trap handlers may be user-defined,
|
||||||
|
written in Pascal, replacing the
|
||||||
default handler that produces an error message and quits.
|
default handler that produces an error message and quits.
|
||||||
You may also generate traps yourself.
|
Also, traps can be generated by the user.
|
||||||
.IP trap 10
|
.IP trap 10
|
||||||
Trap generates the trap passed as argument (0..252).
|
Trap generates the trap passed as argument (0..252).
|
||||||
The trap numbers 128..252 may be used freely. The others are reserved.
|
The trap numbers 128..252 may be used freely. The others are reserved.
|
||||||
|
@ -168,17 +169,17 @@ the previous handler when \fIp\fP returns.
|
||||||
If, during the execution of \fIp\fP, a trap occurs,
|
If, during the execution of \fIp\fP, a trap occurs,
|
||||||
then \fIq\fP is called with the trap number as parameter.
|
then \fIq\fP is called with the trap number as parameter.
|
||||||
For the duration of \fIq\fP the previous trap handler is restored, so that
|
For the duration of \fIq\fP the previous trap handler is restored, so that
|
||||||
you may handle only some of the errors in \fIq\fP. All the other errors must
|
it is possible to only handle some of the errors in \fIq\fP. All the other errors must
|
||||||
then be raised again by a call to \fItrap\fP.
|
then be raised again by a call to \fItrap\fP.
|
||||||
.br
|
.br
|
||||||
Encapsulations may be nested: you may encapsulate a procedure while executing
|
Encapsulations may be nested: a procedure may be encapsulated while executing
|
||||||
an encapsulated routine.
|
an encapsulated routine.
|
||||||
.br
|
.br
|
||||||
Jumping out of an encapsulated procedure (non-local goto) is dangerous,
|
Jumping out of an encapsulated procedure (non-local goto) is dangerous,
|
||||||
because the previous trap handler must be restored.
|
because the previous trap handler must be restored.
|
||||||
Therefore, you may only jump out of procedure \fIp\fP from inside \fIq\fP and
|
Therefore, it is only allowed to jump out of procedure \fIp\fP from inside \fIq\fP and
|
||||||
you may only jump out of one level of encapsulation.
|
it is only allowed to jump out of one level of encapsulation.
|
||||||
If you want to exit several levels of encapsulation, use traps.
|
To exit several levels of encapsulation, the use of traps is required.
|
||||||
See pc_prlib(7) for lists of trap numbers
|
See pc_prlib(7) for lists of trap numbers
|
||||||
for EM machine errors and Pascal run time system errors.
|
for EM machine errors and Pascal run time system errors.
|
||||||
Note that \fIp\fP may not have parameters.
|
Note that \fIp\fP may not have parameters.
|
||||||
|
|
|
@ -267,9 +267,9 @@ Compute array size. Used for copying conformant arrays.
|
||||||
.RE
|
.RE
|
||||||
Debugging facilities:
|
Debugging facilities:
|
||||||
.RS
|
.RS
|
||||||
The compiler allows you to verify assertions.
|
The compiler allows for the verification of assertions.
|
||||||
It generates a call to the routine _ass to check the assertion at runtime.
|
It generates a call to the routine _ass to check the assertion at runtime.
|
||||||
Another feature of the compiler is that it enables you to trace the
|
Another feature of the compiler is that it enables the user to trace the
|
||||||
procedure calling sequence. If the correct option is turned on, then
|
procedure calling sequence. If the correct option is turned on, then
|
||||||
a call to the procedure \fIprocentry\fP is generated at the start of each
|
a call to the procedure \fIprocentry\fP is generated at the start of each
|
||||||
compiled procedure or function. Likewise, the routine \fIprocexit\fP is called
|
compiled procedure or function. Likewise, the routine \fIprocexit\fP is called
|
||||||
|
@ -293,8 +293,8 @@ Files:
|
||||||
.RS
|
.RS
|
||||||
.PP
|
.PP
|
||||||
Most of the runtime routines are needed for file handling.
|
Most of the runtime routines are needed for file handling.
|
||||||
For each file in your Pascal program a record of type file, as described
|
For each file in the Pascal program a record of type file, as described
|
||||||
above, is allocated, static if your file is declared in the outermost block,
|
above, is allocated, static if this file is declared in the outermost block,
|
||||||
dynamic if it is declared in inner blocks.
|
dynamic if it is declared in inner blocks.
|
||||||
The fields in the file record are used for:
|
The fields in the file record are used for:
|
||||||
.IP bufadr 10
|
.IP bufadr 10
|
||||||
|
@ -454,7 +454,7 @@ Otherwise the ELNBIT is cleared.
|
||||||
.IP _wdw
|
.IP _wdw
|
||||||
Return the current pointer to the file window.
|
Return the current pointer to the file window.
|
||||||
.IP _efl
|
.IP _efl
|
||||||
Test if you reached end of file.
|
Test if end of file is reached.
|
||||||
Is always true for output files.
|
Is always true for output files.
|
||||||
.PD
|
.PD
|
||||||
.PP
|
.PP
|
||||||
|
|
Loading…
Reference in a new issue