Procházet zdrojové kódy

Avoid use of 'you'

ceriel před 33 roky
rodič
revize
b3740afbb5

+ 2 - 2
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 ]

+ 2 - 3
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

+ 5 - 4
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

+ 6 - 6
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.

+ 2 - 2
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.

+ 1 - 1
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.

+ 2 - 2
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)

+ 6 - 8
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