doc tweaks for raco {setup,make}

This commit is contained in:
Matthew Flatt 2015-01-08 09:11:38 -07:00
parent c56c9250f1
commit fe9a04d1db
2 changed files with 14 additions and 12 deletions

View File

@ -123,7 +123,7 @@ would create only @filepath{compiled/b_rkt.zo} and
@; ----------------------------------------------------------------------
@section{Dependency Files}
@section[#:tag "Dependency Files"]{Dependency Files}
In addition to a bytecode file, @exec{raco make} creates a file
@filepath{compiled/@nonterm{name}_@nonterm{ext}.dep} that records
@ -538,7 +538,7 @@ messages are instances of a @racket[parallel-compile-event] prefab structure:
@racketblock[
(struct parallel-compile-event (worker event) #:prefab)
].
]
The worker field is the index of the worker that the created the event. The event
field is a @racket[compile-event] as document in

View File

@ -744,13 +744,14 @@ Optional @filepath{info.rkt} fields trigger additional actions by
module. More specifically, used modules are determined when
deleting a @filepath{.dep} file, which would have been created to
accompany a @filepath{.zo} file when the @filepath{.zo} was built
by @exec{raco setup}. If the @filepath{.dep} file indicates another
module, that module's @filepath{.zo} is deleted only if it also has
an accompanying @filepath{.dep} file. In that case, the
@filepath{.dep} file is deleted, and additional used modules are
deleted based on the used module's @filepath{.dep} file, etc.
Supplying a specific list of collections to @exec{raco setup} disables
this dependency-based deletion of compiled files.}
by @exec{raco setup} or @exec{raco make} (see
@secref["Dependency\x20Files"]). If the @filepath{.dep} file
indicates another module, that module's @filepath{.zo} is deleted
only if it also has an accompanying @filepath{.dep} file. In that
case, the @filepath{.dep} file is deleted, and additional used
modules are deleted based on the used module's @filepath{.dep}
file, etc. Supplying a specific list of collections to @exec{raco
setup} disables this dependency-based deletion of compiled files.}
]
@ -816,9 +817,10 @@ with fewer dependencies.
@subsection{How Dependency Checking Works}
Dependency checking uses @filepath{.zo} files, associated
@filepath{.dep} files, and the documentation index. Dynamic
references, such as through @racket[dynamic-require], are not visible
to the dependency checker; only dependencies via @racket[require],
@filepath{.dep} files (see @secref["Dependency Files"]), and the
documentation index. Dynamic references, such as through
@racket[dynamic-require], are not visible to the dependency checker;
only dependencies via @racket[require],
@racket[define-runtime-module-path-index], and other forms that
cooperate with @racket[raco make] are visible for dependency checking.