Avoid informal usage of 'you'

This commit is contained in:
ceriel 1991-11-19 13:09:50 +00:00
parent a0f00e0b2b
commit 92d80c915b
3 changed files with 15 additions and 16 deletions

View file

@ -61,7 +61,7 @@ have not been implemented. The monitor call fails.
.Wn "Inaccessible memory in system call" WMONFLT 21
Bad pointers passed to system calls do not cause a memory fault (which in UNIX
would happen to the kernel), but cause the system call to fail with the UNIX
variable errno set to 14 (EFAULT). It seems likely that your program is at
variable errno set to 14 (EFAULT). It seems likely that the program is at
fault, but there is also a good possibility that a library routine made
unwarranted assumptions about word size and pointer size.
.Wn "READ \- buffer resides in unallocated memory" WRUMEM 23
@ -158,7 +158,7 @@ dynamic link, etc.
This may or may not be an error.
The current implementation of \fIsetjmp()\fP/\fIlongjmp()\fP
may be responsible for it.
If your program does not use setjmp(), there \fIis\fP something
If the program does not use setjmp(), there \fIis\fP something
very wrong (e.g. argument for ASP too large).
Note that there are some library routines (such as \fIalarm()\fP) which
use \fIsetjmp()\fP.
@ -202,7 +202,7 @@ because it results in arithmetic with the NULL pointer.
This warning is generated when the size of the expected return value
is not equal to the size actually returned.
.br
Your interpreted program may have fallen through the end of
An interpreted program may have fallen through the end of
the code without explicitly doing an \fIexit()\fP or \fIreturn()\fP.
The start-up routine (\fIcrt0()\fP) however always expects to get some
value returned by the program proper.

View file

@ -31,17 +31,17 @@ Compile the program into an \fIe.out\fP, the EM machine version of a
if in doubt, use \fIem44\fP. These compilers can be found in the ACK
\fIbin\fP directory, and should be used instead of \fIacc\fP (or normal
.UX
\fIcc\fP). Alternatively, you can use \fIacc \-memNN\fP instead of
\fIcc\fP). Alternatively, \fIacc \-memNN\fP can be used instead of
\fIemNN\fP.
.LP
If your C program consists of more than one file, as it usually does, there is
If a C program consists of more than one file, as it usually does, there is
a small problem. The \fIacc\fP and \fIcc\fP compilers generate .o files,
whereas the \fIemNN\fP compilers generate .m files as object files.
A simple technique to avoid the problem is to call
.DS
em44 *.c
.DE
if you can. If not, the following hack on the \fIMakefile\fP generally works.
if possible. If not, the following hack on the \fIMakefile\fP generally works.
.IP \-
Make sure the \fIMakefile\fP is reasonably clean and complete: all calls to
the compiler are through \fI$(CC)\fP, \fICFLAGS\fP is used properly and all
@ -57,17 +57,17 @@ Add the following lines to the \fIMakefile\fP (possibly permanently):
Set CC to \fIem44 \-.c\fP (for example). Make sure CFLAGS includes
the \-O option; this yields a speed-up of about 15 %.
.IP \-
Change all .o to .m (or .k if you do not use the \-O option).
Change all .o to .m (or .k if the \-O option is not used).
.IP \-
If necessary, change \fIa.out\fP to \fIe.out\fP.
.PP
With these changes, \fImake\fP will produce an EM object; you can use
\fIesize\fP to verify that it is indeed an EM object and obtain some
With these changes, \fImake\fP will produce an EM object;
\fIesize\fP can be used to verify that it is indeed an EM object and obtain some
statistics. Then call the interpreter:
.DS
int <EM-object-file> [ parameters ]
.DE
where the parameters are the normal parameters of your program. This should
where the parameters are the normal parameters of the program. This should
work exactly like the original program, though slower. It reads from the
terminal if the original does, it opens and closes files like the original and
it accepts interrupts.
@ -163,7 +163,7 @@ which is pretty clear as it stands.
.PP
Let's, for the sake of argument
and to avoid the fierce realism of 10000-line programs, assume that the above
still puzzles you.
still does not give enough information.
Since the error occurred in EM instruction number 17, we should like to see
more information around that moment. Call the interpreter again, now with the
shell variable AT set at 17:
@ -172,7 +172,7 @@ int AT=17 t.em
.DE
(The interpreter has a number of internal variables that can be set by
assignments on the command line, like with \fImake\fP.)
This gives you a file called \fIint.log\fP containing the
This gives a file called \fIint.log\fP containing the
stack dump of 150 lines presented at the end of this chapter.
.PP
Since dumping is a subfacility of logging in the interpreter, the formats of
@ -233,7 +233,7 @@ Locals Base at 2147483572 (pointing just above the local \fIa\fP), the Stack
Pointer at 2147483560 (pointing at the undefined pointer), the line count is 4
and the file name is "t.c".
.LP
(Notice that there is one more stack frame than you would probably expect, the
(Notice that there is one more stack frame than one would probably expect, the
one above the start-up routine.)
.LP
The Function Return Area
@ -312,7 +312,7 @@ and indeed at line 18 of the file buff.c we find:
This problem can be avoided by using a specially compiled version of the
library that contains the correct LIN and FIL instructions, or, less
elegantly, by including the source code of the library routines in the
program; in the latter case, make sure you have them all.
program; in the latter case, one has to be sure to have them all.
.sp
.LP
.I "Unavoidable messages"

View file

@ -77,8 +77,7 @@ In general, the lower the \fIdigit\fP following the \fIletter\fP,
the more important the message.
E.g. m5 reports about unsuccessful monitor calls only, m9 also reports
about successful monitors (which are obviously less interesting).
New logging messages can be added to the source code on places you
think relevant.
New logging messages can be added to the source code on relevant places.
.LP
Reasonable settings for the logmask are:
.TS