add start document
svn: r7708
This commit is contained in:
parent
39cedb62ed
commit
048c12100d
3
collects/scribblings/start/info.ss
Normal file
3
collects/scribblings/start/info.ss
Normal file
|
@ -0,0 +1,3 @@
|
|||
(module info setup/infotab
|
||||
(define name "Scribblings: Start")
|
||||
(define scribblings '(("start.scrbl" (main-doc)))))
|
42
collects/scribblings/start/start.scrbl
Normal file
42
collects/scribblings/start/start.scrbl
Normal file
|
@ -0,0 +1,42 @@
|
|||
#lang scribble/doc
|
||||
@require[scribble/manual
|
||||
scribble/struct
|
||||
setup/getinfo
|
||||
setup/main-collects]
|
||||
|
||||
@title{PLT Scheme Documentation}
|
||||
|
||||
@begin[
|
||||
(define initial-ones
|
||||
'("(collects . scribblings/quick/quick.scrbl):top"
|
||||
blank
|
||||
"(collects . scribblings/guide/guide.scrbl):top"
|
||||
"(collects . scribblings/reference/reference.scrbl):top"
|
||||
blank))
|
||||
|
||||
(let* ([dirs (find-relevant-directories '(scribblings))]
|
||||
[infos (map get-info/full dirs)]
|
||||
[docs (apply append
|
||||
(map (lambda (i dir)
|
||||
(let ([s (i 'scribblings)])
|
||||
(map (lambda (d)
|
||||
(if (pair? d)
|
||||
(format "~a:top"
|
||||
(path->main-collects-relative
|
||||
(build-path dir (car d))))
|
||||
(format "bad: ~s" d)))
|
||||
s)))
|
||||
infos
|
||||
dirs))])
|
||||
(make-table
|
||||
#f
|
||||
(map (lambda (doc)
|
||||
(list (make-flow (list (make-paragraph (list
|
||||
(if (eq? doc 'blank)
|
||||
(hspace 1)
|
||||
(secref doc))))))))
|
||||
(append initial-ones
|
||||
(remove* initial-ones
|
||||
(remove "(collects . scribblings/start/start.scrbl):top"
|
||||
docs))))))
|
||||
]
|
|
@ -216,7 +216,9 @@
|
|||
(part-tag-prefix v)
|
||||
src-file
|
||||
p))
|
||||
(set-part-tag-prefix! v p))))
|
||||
(set-part-tag-prefix! v p))
|
||||
(unless (member '(part "top") (part-tags v))
|
||||
(set-part-tags! v (cons '(part "top") (part-tags v))))))
|
||||
|
||||
(define ((get-doc-info only-dirs latex-dest) doc)
|
||||
(let ([info-out-file (build-path (or latex-dest (doc-dest-dir doc)) "xref-out.ss")]
|
||||
|
|
|
@ -2,8 +2,8 @@
|
|||
MzScheme version 4.0 is different from previous versions of MzScheme
|
||||
in several significant ways:
|
||||
|
||||
- The documenation has been re-organized and re-written. Instead of
|
||||
just reference manuals that occassionally provide examples, our
|
||||
- The documentation has been re-organized and re-written. Instead of
|
||||
just reference manuals that occasionally provide examples, our
|
||||
documentation is now based on "guides" that provides a friendly
|
||||
overview and extensive examples, and then separate "references"
|
||||
that provide the details (typically in a more terse, precise
|
||||
|
@ -55,13 +55,13 @@ in several significant ways:
|
|||
|
||||
Library code should generally start with `scheme/base', which is a
|
||||
`mzscheme'-like compromise in terms of size (i.e., code size and
|
||||
liklihood of name collisions) and convenience (i.e., the most
|
||||
likelihood of name collisions) and convenience (i.e., the most
|
||||
commonly used bindings are available). The `scheme' choice is
|
||||
appropriate for programs where the additional functionality of
|
||||
`scheme' is likely to be needed or loaded, anyway.
|
||||
|
||||
- The `#lang' shorthand for `module' is now preferred for a module
|
||||
declaration in a file. In "my-library.ss", istead of
|
||||
declaration in a file. In "my-library.ss", instead of
|
||||
|
||||
(scheme my-library scheme/base
|
||||
(define my-stuff ....)
|
||||
|
@ -75,7 +75,7 @@ in several significant ways:
|
|||
|
||||
Note the absence of the parenthesis wrapping the module content
|
||||
(it is terminated by the end-of-file) and the absence of the
|
||||
redunant identifier `my-library'.
|
||||
redundant identifier `my-library'.
|
||||
|
||||
- Under Unix, "~" is no longer automatically expanded to a user's
|
||||
home directory. The `expand-path' function takes an optional
|
||||
|
@ -95,6 +95,11 @@ in several significant ways:
|
|||
`mzscheme' language). The `require' and `provide' forms expand to
|
||||
`#%require' and `#%provide'.
|
||||
|
||||
- The naming convention for compiled files has changed to preserve
|
||||
the original file suffix. For example, the bytecode version of
|
||||
"x.ss" is now named "x_ss.zo". The "_loader" protocol for
|
||||
native-code extensions is no longer supported.
|
||||
|
||||
======================================================================
|
||||
Immutable and Mutable Pairs
|
||||
======================================================================
|
||||
|
|
Loading…
Reference in New Issue
Block a user