adjust Slideshow to not re-export printable<%>; improve docs for both Slideshow and Scribble

This commit is contained in:
Matthew Flatt 2010-05-13 08:11:34 -06:00
parent 88fd429eaf
commit b072d85107
3 changed files with 21 additions and 13 deletions

View File

@ -27,14 +27,17 @@
@title[#:tag "base"]{Base Document Format} @title[#:tag "base"]{Base Document Format}
@defmodulelang[scribble/base]{The @racketmodname[scribble/base] language @defmodulelang[scribble/base]{The @racketmodname[scribble/base]
provides functions and forms that can be used from code written either language provides functions and forms that can be used from code
in Racket or with @elem["@"] expressions. written either in Racket or with @elem["@"] expressions. It
essentially extends @racketmodname[racket/base], except that top-level
forms within a module using the @racketmodname[scribble/base] language
are treated as document content (like @racketmodname[scribble/doclang]).
The @racketmodname[scribble/base] name can also be used as a The @racketmodname[scribble/base] name can also be used as a library
library with @racket[require], in which case it provides all of the same with @racket[require], in which case it provides only the bindings
bindings, but without setting the reader or setting the default defined in this section, and it also does not set the reader or
rendering format to the Racket manual format.} set the default rendering format to the Racket manual format.}
Functions provided by this library, such as @racket[title] and Functions provided by this library, such as @racket[title] and
@racket[italic], might be called from Racket as @racket[italic], might be called from Racket as

View File

@ -1,5 +1,6 @@
#lang scribble/doc #lang scribble/doc
@(require "ss.ss") @(require "ss.ss"
(for-syntax racket/class))
@(define paper-url "http://www.cs.utah.edu/plt/publications/jfp05-ff.pdf") @(define paper-url "http://www.cs.utah.edu/plt/publications/jfp05-ff.pdf")
@ -18,8 +19,10 @@ To get started, run the @exec{slideshow} executable, and click the
To learn more about why Slideshow is cool, see also ``Slideshow: To learn more about why Slideshow is cool, see also ``Slideshow:
Functional Presentations'' @cite["Findler06"]. Functional Presentations'' @cite["Findler06"].
@defmodulelang*/no-declare[(slideshow)]{Most of the bindings defined in @defmodulelang*/no-declare[(slideshow)]{Most of the bindings defined
the manual are provided by the @racketmodname[slideshow] language.} in the manual are provided by the @racketmodname[slideshow] language,
which also re-exports all of @racketmodname[racket] except for
@racket[printable<%>] (due to backward-compatibility issues).}
@table-of-contents[] @table-of-contents[]

View File

@ -2,7 +2,9 @@
(module main racket (module main racket
(require "base.ss" (require "base.ss"
"pict.ss") "pict.ss")
(provide (all-from-out racket (provide (except-out (all-from-out racket
"base.ss" "base.ss"
"pict.ss"))) "pict.ss")
printable<%>)))