typos (#3668)
* typos * reorder and reword raco exe flags for CS/BC Suggestsions from @sorawee, thanks! * make two suggested edits, retract one
This commit is contained in:
parent
936ac2bf75
commit
a5b14d74b7
|
@ -105,7 +105,7 @@ Racket is available in two implementations, @deftech{CS} and
|
||||||
In general, Racket programs should run the same in all variants.
|
In general, Racket programs should run the same in all variants.
|
||||||
Furthermore, the performance characteristics of Racket program should
|
Furthermore, the performance characteristics of Racket program should
|
||||||
be similar in the @tech{CS} and @tech{BC} implementations. The cases
|
be similar in the @tech{CS} and @tech{BC} implementations. The cases
|
||||||
where a program may depends on the implementation will typically
|
where a program may depend on the implementation will typically
|
||||||
involve interactions with foreign libraries; in particular, the Racket
|
involve interactions with foreign libraries; in particular, the Racket
|
||||||
C API described in @other-doc[inside-doc] is different for the
|
C API described in @other-doc[inside-doc] is different for the
|
||||||
@tech{CS} implementation versus the @tech{BC} implementation.
|
@tech{CS} implementation versus the @tech{BC} implementation.
|
||||||
|
@ -138,7 +138,7 @@ variant-independent format on all Racket implementations, but running
|
||||||
code in that format requires an additional internal conversion step to
|
code in that format requires an additional internal conversion step to
|
||||||
the implementation's main bytecode format.
|
the implementation's main bytecode format.
|
||||||
|
|
||||||
Machine-independent bytecode for @tech{BC} implementation is further
|
Machine-independent bytecode for the @tech{BC} implementation is further
|
||||||
compiled to native code via a @deftech{just-in-time} or @deftech{JIT}
|
compiled to native code via a @deftech{just-in-time} or @deftech{JIT}
|
||||||
compiler. The @tech{JIT} compiler substantially speeds programs that
|
compiler. The @tech{JIT} compiler substantially speeds programs that
|
||||||
execute tight loops, arithmetic on small integers, and arithmetic on
|
execute tight loops, arithmetic on small integers, and arithmetic on
|
||||||
|
@ -147,7 +147,7 @@ for x86, x86_64 (a.k.a. AMD64), 32-bit ARM, and 32-bit PowerPC processors.
|
||||||
The @tech{JIT} compiler can be disabled via the
|
The @tech{JIT} compiler can be disabled via the
|
||||||
@racket[eval-jit-enabled] parameter or the @DFlag{no-jit}/@Flag{j}
|
@racket[eval-jit-enabled] parameter or the @DFlag{no-jit}/@Flag{j}
|
||||||
command-line flag for @exec{racket}. Setting @racket[eval-jit-enabled]
|
command-line flag for @exec{racket}. Setting @racket[eval-jit-enabled]
|
||||||
to @racket[#f] has not effect on the @tech{CS} implementation of Racket.
|
to @racket[#f] has no effect on the @tech{CS} implementation of Racket.
|
||||||
|
|
||||||
The @tech{JIT} compiler works incrementally as functions are applied,
|
The @tech{JIT} compiler works incrementally as functions are applied,
|
||||||
but the @tech{JIT} compiler makes only limited use of run-time
|
but the @tech{JIT} compiler makes only limited use of run-time
|
||||||
|
|
|
@ -185,17 +185,19 @@ The @exec{raco exe} command accepts the following command-line flags:
|
||||||
libraries when the executable is distributed to a different
|
libraries when the executable is distributed to a different
|
||||||
machine).}
|
machine).}
|
||||||
|
|
||||||
|
@item{@DFlag{cs} --- generate an executable based on the @gtech{CS}
|
||||||
|
implementation of Racket, which is the default unless running a
|
||||||
|
@exec{raco exe} that is based on the @gtech{BC} implementation.}
|
||||||
|
|
||||||
@item{@DFlag{3m} --- generate an executable based on the @gtech{3m}
|
@item{@DFlag{3m} --- generate an executable based on the @gtech{3m}
|
||||||
variant of Racket, which is the default unless running a @exec{raco
|
variant of Racket, which is the default only when running a @exec{raco
|
||||||
exe} that is based on the @gtech{CGC} or @gtech{CS} variant.}
|
exe} that is based on the @gtech{3m} variant of the @gtech{BC}
|
||||||
|
implementation.}
|
||||||
|
|
||||||
@item{@DFlag{cgc} --- generate an executable based on the @gtech{CGC}
|
@item{@DFlag{cgc} --- generate an executable based on the @gtech{CGC}
|
||||||
variant of Racket, which is the default only when running a
|
variant of Racket, which is the default only when running a
|
||||||
@exec{raco exe} that is based on the @gtech{CGC} variant.}
|
@exec{raco exe} that is based on the @gtech{CGC} variant
|
||||||
|
of the @gtech{BC} implementation.}
|
||||||
@item{@DFlag{cs} --- generate an executable based on the @gtech{CS}
|
|
||||||
variant of Racket, which is the default only when running a
|
|
||||||
@exec{raco exe} that is based on the @gtech{CS} variant.}
|
|
||||||
|
|
||||||
@item{@DPFlag{aux} @nonterm{file} --- attach information to the
|
@item{@DPFlag{aux} @nonterm{file} --- attach information to the
|
||||||
executable based on @nonterm{file}'s suffix; see
|
executable based on @nonterm{file}'s suffix; see
|
||||||
|
|
|
@ -22,7 +22,7 @@ parameter to @racket[#f] or supplying the @DFlag{compile-any}/@Flag{M}
|
||||||
flag on startup. See @racket[current-compile-target-machine] for more
|
flag on startup. See @racket[current-compile-target-machine] for more
|
||||||
information.
|
information.
|
||||||
|
|
||||||
Other compilation modes depend on the Racket variant (see
|
Other compilation modes depend on the Racket implementation (see
|
||||||
@secref["implementations"]).
|
@secref["implementations"]).
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -19,27 +19,27 @@ the implementation. Racket currently has two main implementations:
|
||||||
specific to an operating system and architecture.}
|
specific to an operating system and architecture.}
|
||||||
|
|
||||||
@item{The @deftech{BC} implementation was the default implementation
|
@item{The @deftech{BC} implementation was the default implementation
|
||||||
up until version 7.8. The ``BC'' label stands for ``before
|
up until version 7.9. The ``BC'' label stands for ``before
|
||||||
Chez'' or ``bytecode.''
|
Chez'' or ``bytecode.''
|
||||||
|
|
||||||
Compiled Racket BC code in a @filepath{.zo} file normally
|
Compiled Racket BC code in a @filepath{.zo} file normally
|
||||||
contains platform-independent bytecode that is further compiled
|
contains platform-independent bytecode that is further compiled
|
||||||
to machine code ``just in time'' as the code is loaded.
|
to machine code ``just in time'' as the code is loaded.
|
||||||
|
|
||||||
Racket BC has two subvariants: @deftech{3m} and @deftech{CGC}.
|
Racket BC has two variants: @deftech{3m} and @deftech{CGC}.
|
||||||
The difference is the @tech{garbage collection} implementation,
|
The difference is the @tech{garbage collection} implementation,
|
||||||
where 3m uses a garbage collector that moves objects in memory
|
where 3m uses a garbage collector that moves objects in memory
|
||||||
(an effect that is visible to foreign libraries, for example)
|
(an effect that is visible to foreign libraries, for example)
|
||||||
and keeps precise track of allocated objects, while CGC uses a
|
and keeps precise track of allocated objects, while CGC uses a
|
||||||
``conservative'' collector that requires less cooperation from
|
``conservative'' collector that requires less cooperation from
|
||||||
an embedding foreign environment. The 3m subvariant tends to
|
an embedding foreign environment. The 3m subvariant tends to
|
||||||
perform much better than CGC, and it because the default
|
perform much better than CGC, and it became the default
|
||||||
variant in version 370 (which would be v3.7 in the current
|
variant in version 370 (which would be v3.7 in the current
|
||||||
versioning convention).}
|
versioning convention).}
|
||||||
|
|
||||||
]
|
]
|
||||||
|
|
||||||
Most Racket programs run the same in all variants, but some Racket
|
Most Racket programs run the same in all implementation variants, but some Racket
|
||||||
features are available only on some implementation variants, and the
|
features are available only on some implementation variants, and the
|
||||||
interaction of Racket and foreign functions is significantly different
|
interaction of Racket and foreign functions is significantly different
|
||||||
across the variants. Use @racket[system-type] to get information about
|
across the variants. Use @racket[system-type] to get information about
|
||||||
|
|
Loading…
Reference in New Issue
Block a user