From 2b6f5b9b8d894fdf9ad836f91f5a555830bdadfd Mon Sep 17 00:00:00 2001 From: ceriel Date: Fri, 22 Nov 1991 13:18:57 +0000 Subject: [PATCH] Avoid use of 'you' --- lang/m2/comp/modula-2.1 | 4 ++-- modules/src/em_code/em_code.3X | 5 ++--- modules/src/object/object.3 | 9 +++++---- util/ack/ack.1.X | 12 ++++++------ util/ass/em_ass.6 | 4 ++-- util/int/int.1 | 2 +- util/led/led.6 | 4 ++-- util/misc/em_decode.6 | 14 ++++++-------- 8 files changed, 26 insertions(+), 28 deletions(-) diff --git a/lang/m2/comp/modula-2.1 b/lang/m2/comp/modula-2.1 index e48099d78..206d33bb7 100644 --- a/lang/m2/comp/modula-2.1 +++ b/lang/m2/comp/modula-2.1 @@ -9,7 +9,7 @@ Modula-2 \- ACK Modula-2 compiler .SH INTRODUCTION This document provides a short introduction to the use of the ACK Modula-2 compiler. It also -tells you where to find definition modules for "standard" modules. +mentions the location of definition modules for "standard" modules. .SH FILENAMES Usually, a Modula-2 program consists of several definition and implementation modules, and one program module. @@ -25,7 +25,7 @@ the compiler will try to open a file called "LongModulN.def". The requirement does not hold for implementation or program modules, but is certainly recommended. .SH CALLING THE COMPILER -The easiest way to do this is to let the \fIack\fR(1) program do it for you. +The easiest way to do this is to let the \fIack\fR(1) program do it. So, to compile a program module "prog.mod", just call .nf \fBack\fR \-m\fImach\fR prog.mod [ objects of implementation modules ] diff --git a/modules/src/em_code/em_code.3X b/modules/src/em_code/em_code.3X index f17cf0c32..b9b9ba0a4 100644 --- a/modules/src/em_code/em_code.3X +++ b/modules/src/em_code/em_code.3X @@ -126,10 +126,9 @@ and .PP .B C_busy can be invoked in order -to detect whether EM code is currently being generated, i.e. whether you are -in between calls to +to detect whether EM code is currently being generated, i.e. whether .B C_open -and +is invoked without a corresponding .BR C_close . If this is the case, .B C_busy diff --git a/modules/src/object/object.3 b/modules/src/object/object.3 index f838c73f8..cd9e50e17 100644 --- a/modules/src/object/object.3 +++ b/modules/src/object/object.3 @@ -271,9 +271,9 @@ initialises for reading an "object file" from file descriptor at its current position. This is useful for reading an object that resides in an archive. It returns 1 if it succeeds, 0 otherwise. -If you use this entry point for reading, you don't have to call +When using this entry point for reading, .I rd_close -to close the file. You can close the file yourself. +does not have to be called. .PP .I Rd_rew_relo rewinds the relocation part, so that it can be read again. @@ -287,9 +287,10 @@ and interpretes them as an unsigned integer. .I Rd_arhdr returns 1 if a header was read, and 0 on end-of-file. .PP -When using any of the reading routines, you must define a routine +When using any of the reading routines, a routine named -.IB rd_fatal . +.I rd_fatal +must be defined. It is called when a read fails, and is not supposed to return. Likewise, a routine .I wr_fatal diff --git a/util/ack/ack.1.X b/util/ack/ack.1.X index bc7f41363..5dbb1cd39 100644 --- a/util/ack/ack.1.X +++ b/util/ack/ack.1.X @@ -227,8 +227,8 @@ Use Definition analysis (UD) may introduce opportunities for LV. Strength Reduction (SR) may create opportunities for UD. .RE .IP "" -The global optimizer is a combiner, so, when using it, offer it all the source -files of your program. This is not strictly necessary, but it makes the +The global optimizer is a combiner, so it should be offered all the source +files of the program. This is not strictly necessary, but it makes the global optimizer more effective. The current default optimization phases are: .RS @@ -278,7 +278,7 @@ as an option string to the Pascal compiler and supersedes corresponding options given in the source file. See the ACK reference manual [4] for a list of options. .IP "\-+xxx, \-\-xxx" -When you want to interpret your program, you may select some +When interpreting programs, these flags are used to select some options during interpretation, like test, profile, flow, extra and count. A short description of these flags follows: .RS @@ -292,9 +292,9 @@ count the number of times a source line is executed. count the memory cycles executed per source line. .RE .IP "" 5 -Test is on by default, the others are off. Normally, you give these -flag options each time you run the interpreter. -The EM assembler/linker gives you the opportunity to change +Test is on by default, the others are off. Normally, these +flag options are given each time the interpreter is run. +The EM assembler/linker offers the opportunity to change the defaults per program. The changed options are recorded in the "e.out" header. These flags \-\- and \-+ are passed to the assembler for this purpose. diff --git a/util/ass/em_ass.6 b/util/ass/em_ass.6 index 993f87e5a..20a591d8d 100644 --- a/util/ass/em_ass.6 +++ b/util/ass/em_ass.6 @@ -11,7 +11,7 @@ Em_ass assembles and links EM modules. Arguments may be flags, EM modules or libraries. Flags recognized are: .IP "-ss, -sm, -sl, -sx" -Indicate that your program is small, medium, large, or extra large. +Indicate that the program is small, medium, large, or extra large. Large is the default. .IP -p List all procedure names together with base-address (decimal and octal), @@ -64,7 +64,7 @@ produced code the only messages to expect are "Out of memory" or of the form: Overflow in XXXX. The latter can usually be cured by giving a -sx flag, -the former means your program is too big, dimishing +the former means the program is too big, dimishing the size of very large procedures can sometimes help. The most likely errors, however, are unresolved references, probably caused by the omission of a library argument. diff --git a/util/int/int.1 b/util/int/int.1 index a224af766..4042c321b 100644 --- a/util/int/int.1 +++ b/util/int/int.1 @@ -139,7 +139,7 @@ implemented. All diagnostics are written to the message file. Diagnostics come in three flavors: .IP \- -(messages): These inform you about NOP instructions, give more information +(messages): These mention NOP instructions, give more information about incoming signals and display the exit status of the program. .IP \- (warnings): These are generated as a result of the checking. diff --git a/util/led/led.6 b/util/led/led.6 index 3d2883738..b3fa2eca3 100644 --- a/util/led/led.6 +++ b/util/led/led.6 @@ -120,9 +120,9 @@ For each member of a library that is linked, give a message on standard error telling why .I led chose to link it (which unresolved reference it resolves). -This option is useful if you have 'multiply defined' problems. +This option is useful in resolving 'multiply defined' problems. .SH FILES -~em/lib/em_led +~em/lib.bin/em_led a.out output file .SH "SEE ALSO" ack(1) diff --git a/util/misc/em_decode.6 b/util/misc/em_decode.6 index c293d7b73..ada42dfa3 100644 --- a/util/misc/em_decode.6 +++ b/util/misc/em_decode.6 @@ -15,16 +15,14 @@ EM programs in compact form. These files are only machine readable. A description of this compact form can be found in [1]. To inspect the code produced by compilers or to patch them for one reason -or another, you need human readable assembly code. -Em_decode will do the job for you. +or another, human readable assembly code is needed. +Em_decode produces human readable assembly code from the compact form. .PP Em_decode accepts the normal compact form in both optimized and -unoptimized form +unoptimized form. .PP -Sometimes you have to make some special routines directly -in EM, for instance the routines implementing the system calls. -At these times you may use em_encode to produce compact routines -out of these human readable assembly modules. +Em_encode produces the compact form +out of these human readable assembly code. .PP The first argument is the input file. The second argument is the output file. @@ -35,7 +33,7 @@ A.S.Tanenbaum, Ed Keizer, Hans van Staveren & J.W.Stevenson "Description of a machine architecture for use of block structured languages" Informatica rapport IR-81. .IP [2] -ack(I) +ack(1) .SH DIAGNOSTICS Error messages are intended to be self-explanatory. .SH AUTHOR