Avoid informal usage of 'you'
This commit is contained in:
		
							parent
							
								
									a0f00e0b2b
								
							
						
					
					
						commit
						92d80c915b
					
				
					 3 changed files with 15 additions and 16 deletions
				
			
		|  | @ -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. | ||||
|  |  | |||
							
								
								
									
										22
									
								
								doc/int/appB
									
										
									
									
									
								
							
							
						
						
									
										22
									
								
								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" | ||||
|  |  | |||
|  | @ -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 | ||||
|  |  | |||
		Loading…
	
	Add table
		
		Reference in a new issue