Avoid use of 'you'

This commit is contained in:
ceriel 1991-11-22 13:18:57 +00:00
parent fad1c30409
commit 2b6f5b9b8d
8 changed files with 26 additions and 28 deletions

View file

@ -9,7 +9,7 @@ Modula-2 \- ACK Modula-2 compiler
.SH INTRODUCTION .SH INTRODUCTION
This document provides a short introduction to the use of the ACK Modula-2 This document provides a short introduction to the use of the ACK Modula-2
compiler. It also compiler. It also
tells you where to find definition modules for "standard" modules. mentions the location of definition modules for "standard" modules.
.SH FILENAMES .SH FILENAMES
Usually, a Modula-2 program consists of several definition and implementation Usually, a Modula-2 program consists of several definition and implementation
modules, and one program module. 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, The requirement does not hold for implementation or program modules,
but is certainly recommended. but is certainly recommended.
.SH CALLING THE COMPILER .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 So, to compile a program module "prog.mod", just call
.nf .nf
\fBack\fR \-m\fImach\fR prog.mod [ objects of implementation modules ] \fBack\fR \-m\fImach\fR prog.mod [ objects of implementation modules ]

View file

@ -126,10 +126,9 @@ and
.PP .PP
.B C_busy .B C_busy
can be invoked in order can be invoked in order
to detect whether EM code is currently being generated, i.e. whether you are to detect whether EM code is currently being generated, i.e. whether
in between calls to
.B C_open .B C_open
and is invoked without a corresponding
.BR C_close . .BR C_close .
If this is the case, If this is the case,
.B C_busy .B C_busy

View file

@ -271,9 +271,9 @@ initialises for reading an "object file" from file descriptor
at its current position. at its current position.
This is useful for reading an object that resides in an archive. This is useful for reading an object that resides in an archive.
It returns 1 if it succeeds, 0 otherwise. 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 .I rd_close
to close the file. You can close the file yourself. does not have to be called.
.PP .PP
.I Rd_rew_relo .I Rd_rew_relo
rewinds the relocation part, so that it can be read again. 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 .I Rd_arhdr
returns 1 if a header was read, and 0 on end-of-file. returns 1 if a header was read, and 0 on end-of-file.
.PP .PP
When using any of the reading routines, you must define a routine When using any of the reading routines, a routine
named named
.IB rd_fatal . .I rd_fatal
must be defined.
It is called when a read fails, and is not supposed to return. It is called when a read fails, and is not supposed to return.
Likewise, a routine Likewise, a routine
.I wr_fatal .I wr_fatal

View file

@ -227,8 +227,8 @@ Use Definition analysis (UD) may introduce opportunities for LV.
Strength Reduction (SR) may create opportunities for UD. Strength Reduction (SR) may create opportunities for UD.
.RE .RE
.IP "" .IP ""
The global optimizer is a combiner, so, when using it, offer it all the source The global optimizer is a combiner, so it should be offered all the source
files of your program. This is not strictly necessary, but it makes the files of the program. This is not strictly necessary, but it makes the
global optimizer more effective. global optimizer more effective.
The current default optimization phases are: The current default optimization phases are:
.RS .RS
@ -278,7 +278,7 @@ as an option string to the Pascal compiler and supersedes corresponding
options given in the source file. options given in the source file.
See the ACK reference manual [4] for a list of options. See the ACK reference manual [4] for a list of options.
.IP "\-+xxx, \-\-xxx" .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. options during interpretation, like test, profile, flow, extra and count.
A short description of these flags follows: A short description of these flags follows:
.RS .RS
@ -292,9 +292,9 @@ count the number of times a source line is executed.
count the memory cycles executed per source line. count the memory cycles executed per source line.
.RE .RE
.IP "" 5 .IP "" 5
Test is on by default, the others are off. Normally, you give these Test is on by default, the others are off. Normally, these
flag options each time you run the interpreter. flag options are given each time the interpreter is run.
The EM assembler/linker gives you the opportunity to change The EM assembler/linker offers the opportunity to change
the defaults per program. the defaults per program.
The changed options are recorded in the "e.out" header. The changed options are recorded in the "e.out" header.
These flags \-\- and \-+ are passed to the assembler for this purpose. These flags \-\- and \-+ are passed to the assembler for this purpose.

View file

@ -11,7 +11,7 @@ Em_ass assembles and links EM modules.
Arguments may be flags, EM modules or libraries. Arguments may be flags, EM modules or libraries.
Flags recognized are: Flags recognized are:
.IP "-ss, -sm, -sl, -sx" .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. Large is the default.
.IP -p .IP -p
List all procedure names together with base-address (decimal and octal), 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 or of the
form: Overflow in XXXX. The latter can usually be cured by giving form: Overflow in XXXX. The latter can usually be cured by giving
a -sx flag, 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 size of very large procedures can sometimes help.
The most likely errors, however, are unresolved references, The most likely errors, however, are unresolved references,
probably caused by the omission of a library argument. probably caused by the omission of a library argument.

View file

@ -139,7 +139,7 @@ implemented.
All diagnostics are written to the message file. All diagnostics are written to the message file.
Diagnostics come in three flavors: Diagnostics come in three flavors:
.IP \- .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. about incoming signals and display the exit status of the program.
.IP \- .IP \-
(warnings): These are generated as a result of the checking. (warnings): These are generated as a result of the checking.

View file

@ -120,9 +120,9 @@ For each member of a library that is linked, give a message on standard
error telling why error telling why
.I led .I led
chose to link it (which unresolved reference it resolves). 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 .SH FILES
~em/lib/em_led ~em/lib.bin/em_led
a.out output file a.out output file
.SH "SEE ALSO" .SH "SEE ALSO"
ack(1) ack(1)

View file

@ -15,16 +15,14 @@ EM programs in compact form.
These files are only machine readable. These files are only machine readable.
A description of this compact form can be found in [1]. 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 To inspect the code produced by compilers or to patch them for one reason
or another, you need human readable assembly code. or another, human readable assembly code is needed.
Em_decode will do the job for you. Em_decode produces human readable assembly code from the compact form.
.PP .PP
Em_decode accepts the normal compact form in both optimized and Em_decode accepts the normal compact form in both optimized and
unoptimized form unoptimized form.
.PP .PP
Sometimes you have to make some special routines directly Em_encode produces the compact form
in EM, for instance the routines implementing the system calls. out of these human readable assembly code.
At these times you may use em_encode to produce compact routines
out of these human readable assembly modules.
.PP .PP
The first argument is the input file. The first argument is the input file.
The second argument is the output 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 "Description of a machine architecture for use of
block structured languages" Informatica rapport IR-81. block structured languages" Informatica rapport IR-81.
.IP [2] .IP [2]
ack(I) ack(1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
Error messages are intended to be self-explanatory. Error messages are intended to be self-explanatory.
.SH AUTHOR .SH AUTHOR