376dd5f4aa
The `dynamic-rerequire' function is the reloading support of `enter!', but in function form and without namespace-switching.
43 lines
1.6 KiB
Racket
43 lines
1.6 KiB
Racket
#lang scribble/doc
|
|
@(require "mz.rkt"
|
|
(for-label racket/enter
|
|
racket/rerequire))
|
|
|
|
@title[#:tag "enter"]{Entering Modules}
|
|
|
|
@note-init-lib[racket/enter]
|
|
|
|
@defform*/subs[[(enter! module-path)
|
|
(enter! #f)
|
|
(enter! module-path flag ...+)]
|
|
([flag #:quiet
|
|
#:verbose-reload
|
|
#:verbose
|
|
#:dont-re-require-enter])]{
|
|
|
|
Intended for use in a @tech{REPL}, such as when @exec{racket} is
|
|
started in interactive mode. When a @racket[module-path] is provided
|
|
(in the same sense as for @racket[require]), the corresponding module
|
|
is loaded or invoked via @racket[dynamic-rerequire], and the current @tech{namespace} is changed to
|
|
the body of the module via @racket[module->namespace]. When
|
|
@racket[#f] is provided, then the current @tech{namespace} is restored
|
|
to the original one.
|
|
|
|
Additional @racket[flag]s can customize aspects of @racket[enter!]:
|
|
@itemize[
|
|
|
|
@item{The @racket[#:verbose], @racket[#:verbose-reload], and
|
|
@racket[#:quiet] flags correspond to @racket['all],
|
|
@racket['reload], and @racket['none] verbosity for
|
|
@racket[dynamic-rerequire]. The default corresponds to
|
|
@racket[#:verbose-reload].}
|
|
|
|
@item{After switching namespaces to the designated module,
|
|
@racket[enter!] automatically requires @racket[racket/enter] into the
|
|
namespace, so that @racket[enter!] can be used to switch namespaces
|
|
again. In some cases, requiring @racket[racket/enter]
|
|
might not be desirable (e.g., in a tool
|
|
that uses @racket[racket/enter]); use the
|
|
@racket[#:dont-re-require-enter] flag to disable the require.}]
|
|
}
|