Browse Source

Avoid informal usage of 'you'

ceriel 33 years ago
parent
commit
92d80c915b
3 changed files with 15 additions and 16 deletions
  1. 3 3
      doc/int/appA
  2. 11 11
      doc/int/appB
  3. 1 2
      doc/int/txt3

+ 3 - 3
doc/int/appA

@@ -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.

+ 11 - 11
doc/int/appB

@@ -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"

+ 1 - 2
doc/int/txt3

@@ -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