From a8062dc37d835939196e7c38e59cc8eae3d15d5c Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Wed, 7 Jul 2010 06:18:34 -0600 Subject: [PATCH] fix docs on `raco make --no-deps' Closes PR 11018 --- collects/compiler/commands/make.rkt | 2 +- collects/scribblings/raco/make.scrbl | 17 +++++------------ 2 files changed, 6 insertions(+), 13 deletions(-) diff --git a/collects/compiler/commands/make.rkt b/collects/compiler/commands/make.rkt index 57ae63c1c4..5cfd96af01 100644 --- a/collects/compiler/commands/make.rkt +++ b/collects/compiler/commands/make.rkt @@ -19,7 +19,7 @@ #:once-each [("--disable-inline") "Disable procedure inlining during compilation" (disable-inlining #t)] - [("--no-deps") "Compile immediate files without updating depdencies" + [("--no-deps") "Compile immediate files without updating dependencies" (disable-deps #t)] [("-p" "--prefix") file "Add elaboration-time prefix file for --no-deps" (prefixes (append (prefixes) (list file)))] diff --git a/collects/scribblings/raco/make.scrbl b/collects/scribblings/raco/make.scrbl index 0640dc1f3e..a78e063870 100644 --- a/collects/scribblings/raco/make.scrbl +++ b/collects/scribblings/raco/make.scrbl @@ -320,24 +320,17 @@ path of an included file as it expands an @racket[include] form.} @section[#:tag "zo"]{Compiling to Raw Bytecode} -The @DFlag{zo}/@Flag{z} mode for @exec{raco make} is an improverished +The @DFlag{no-deps} mode for @exec{raco make} is an improverished form of the compilation, because it does not track import dependencies. It does, however, support compilation of non-module -source. - -By default, the generated bytecode is placed in the same directory as -the source file---which is not where it will be found automatically -when loading the source. Use the @as-index{@DFlag{auto-dir}} flag to -redirect the output to a @filepath{compiled} subdirectory, where it -will be found automatically when loading the source file. +source in an namespace that iniitially imports @racketmodname[scheme]. Outside of a module, top-level @racket[define-syntaxes], @racket[module], @racket[#%require], @racket[define-values-for-syntax], and and @racket[begin] expressions -are handled specially by @exec{raco make --zo}: the compile-time +are handled specially by @exec{raco make --no-deps}: the compile-time portion of the expression is evaluated, because it might affect later -expressions. (The @Flag{m} or @DFlag{module} flag turns off this -special handling.) +expressions. For example, when compiling the file containing @@ -353,7 +346,7 @@ code) and evaluated (for further computation). Many definition forms expand to @racket[define-syntaxes]. For example, @racket[define-signature] expands to @racket[define-syntaxes]. In -@racket[--zo] mode, @exec{raco make --zo} detects +@DFlag{no-deps} mode, @exec{raco make --no-deps} detects @racket[define-syntaxes] and other expressions after expansion, so top-level @racket[define-signature] expressions affect the compilation of later expressions, as a programmer would expect.