suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

break various documentation dependencies by making them indirect

Browse Source 
An "indirect" reference is resolved when HTML is loaded,
instead of at document-build time.
This commit is contained in:
Matthew Flatt 2013-07-11 15:46:46 -06:00
parent 8cf13c3f46
commit 3b89a05d46
10 changed files with 27 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
pkgs/drracket-pkgs/drracket/scribblings/drracket/languages.scrbl
View File

@ -100,7 +100,7 @@ without a @hash-lang[] prefix:
@racketmodname[mzlib/shared].}
@item{The @as-index{@drlang{Swindle} language} starts with the same
bindings as @racketmodname[swindle], and evaluates the program like
bindings as @racketmodname[swindle #:indirect], and evaluates the program like
@racket[load].}
]
@ -358,11 +358,14 @@ by three calls to @racket[read-line].
@section[#:tag "experimental-langs"]{Other Experimental Languages}
For information on @onscreen{Lazy Racket}, see @other-manual['(lib "lazy/lazy.scrbl")].
For information on @onscreen{Lazy Racket}, see @seclink["top" #:doc
'(lib "lazy/lazy.scrbl") #:indirect? #t]{the Lazy Racket documentation}.
For information on @onscreen{FrTime}, see @other-manual['(lib "frtime/scribblings/frtime.scrbl")].
For information on @onscreen{FrTime}, see @seclink["top" #:doc '(lib
"frtime/scribblings/frtime.scrbl") #:indirect? #t]{the FrTime documentation}.
For information on @onscreen{Algol 60}, see @other-manual['(lib "algol60/algol60.scrbl")].
For information on @onscreen{Algol 60}, see @seclink["top" #:doc '(lib
"algol60/algol60.scrbl") #:indirect? #t]{the Algol60 documentation}.
@; ----------------------------------------

2
pkgs/gui-pkgs/gui-doc/mrlib/scribblings/cache-image-snip.scrbl
View File

@ -20,7 +20,7 @@
@deprecated[@racketmodname[racket/gui]]{This library will
no longer be public in a future release; much of it will
be available privately to continue to support the implementation
of @racket[htdp/image], but the other exported functions
of @racketmodname[htdp/image #:indirect], but the other exported functions
here are not useful and have names that confusingly match
unrelated other libraries.}

2
pkgs/gui-pkgs/gui-doc/mrlib/scribblings/image-core.scrbl
View File

@ -5,7 +5,7 @@
@defmodule[mrlib/image-core]
This library is the core part of the @racketmodname[2htdp/image] library that DrRacket
This library is the core part of the @racketmodname[2htdp/image #:indirect] library that DrRacket
links into the namespace of all languages that it runs. This ensures that minimal
support for these images are the same in all languages, specifically including
support for printing the images and constructing the core data structures making

2
pkgs/gui-pkgs/gui-doc/mrlib/scribblings/plot.scrbl
View File

@ -7,7 +7,7 @@
a simple tool for plotting data values to a device context.}
@bold{This is an old library, kept only for compatibility.} You will
undoubtedly want to use the @racketmodname[plot] library instead, which offers
undoubtedly want to use the @racketmodname[plot #:indirect] library instead, which offers
many more features and is actively maintained.
@defstruct[data-set ([points (listof (is-a?/c point%))]

2
pkgs/pict-pkgs/pict-doc/pict/scribblings/pict.scrbl
View File

@ -20,7 +20,7 @@
@defmodule*/no-declare[(pict)]{ The
@racketmodname[pict] library is one of the standard Racket
functional picture libraries (the other being @racketmodname[2htdp/image]).
functional picture libraries (the other being @racketmodname[2htdp/image #:indirect]).
This library was original designed for use with
@seclink[#:doc '(lib "scribblings/slideshow/slideshow.scrbl") "top"]{Slideshow},
and is re-provided by the @racketmodname[slideshow] language.}

6
pkgs/r5rs-pkgs/r5rs-doc/r5rs/r5rs.scrbl
View File

@ -53,8 +53,10 @@ according to @|r5rs|:
@item{DrRacket provides an @onscreen{R5RS} language, which can be
selected via the @menuitem["Language" "Choose Language..."]
menu item. See @secref[#:doc drs-doc "choose-language"] in
@other-manual[drs-doc] for more information.}
menu item. See @seclink[#:doc drs-doc "choose-language"
#:indirect? #t]{@onscreen{Choose Language...}} in
@seclink["top" #:doc drs-doc #:indirect? #t]{the DrRacket
documentation} for more information.}
@item{The @exec{plt-r5rs} executable runs an @|r5rs| program or
provides a read-eval-print loop for evaluating @|r5rs|

15
pkgs/racket-pkgs/racket-doc/scribblings/guide/dialects.scrbl
View File

@ -44,13 +44,16 @@ including the following:
@racketmodname[racket], but statically typed; see
@other-manual['(lib "typed-racket/scribblings/ts-guide.scrbl")]}
@item{@racketmodname[lazy] --- like @racketmodname[racket/base], but
avoids evaluating an expression until its value is needed; see
@other-manual['(lib "lazy/lazy.scrbl")]}
@item{@racketmodname[lazy #:indirect] --- like
@racketmodname[racket/base], but avoids evaluating an
expression until its value is needed; see @seclink["top" #:doc
'(lib "lazy/lazy.scrbl") #:indirect? #t]{the Lazy Racket
documentation}.}
@item{@racketmodname[frtime] --- changes evaluation in an even more
radical way to support reactive programming; see
@other-manual['(lib "frtime/scribblings/frtime.scrbl")]}
@item{@racketmodname[frtime #:indirect] --- changes evaluation in an
even more radical way to support reactive programming; see
@seclink["top" #:doc '(lib "frtime/scribblings/frtime.scrbl")
#:indirect? #t]{the FrTime documentation}.}
@item{@racketmodname[scribble/base] --- a language, which looks more
like Latex than Racket, for writing documentation; see

2
pkgs/racket-pkgs/racket-doc/scribblings/reference/syntax.scrbl
View File

@ -678,7 +678,7 @@ corresponds to the default @tech{module name resolver}.
@tech{collection}, and @filepath{main.rkt} is the library file name.
@examples[
(code:comment @#,t{the main @racketmodname[swindle] library:})
(code:comment @#,t{the main @racketmodname[swindle #:indirect] library:})
(eval:alts (require (lib "swindle")) (void))
(code:comment @#,t{the same:})
(eval:alts (require (lib "swindle/main.rkt")) (void))]}

2
pkgs/scribble-pkgs/scribble-doc/scribblings/scribble/how-to-paper.scrbl
View File

@ -646,7 +646,7 @@ renders as
Any value that is convertable to an image can be used directly within
a Scribble document. Functions from the @racketmodname[pict]
and @racketmodname[2htdp/image] libraries, for example, generate
and @racketmodname[2htdp/image #:indirect] libraries, for example, generate
images. For example,
@sample|{

3
pkgs/syntax-color-pkgs/syntax-color-doc/syntax-color/syntax-color.scrbl
View File

@ -16,8 +16,7 @@
The @filepath{syntax-color} collection provides the underlying data
structures and some helpful utilities for the @racket[color:text<%>]
class of the @other-manual['(lib
"scribblings/framework/framework.scrbl")].
class of @racketmodname[framework].
@; ----------------------------------------------------------------------