diff --git a/collects/scribblings/start/info.ss b/collects/scribblings/start/info.ss new file mode 100644 index 0000000000..7378ac201c --- /dev/null +++ b/collects/scribblings/start/info.ss @@ -0,0 +1,3 @@ +(module info setup/infotab + (define name "Scribblings: Start") + (define scribblings '(("start.scrbl" (main-doc))))) diff --git a/collects/scribblings/start/start.scrbl b/collects/scribblings/start/start.scrbl new file mode 100644 index 0000000000..9c02a8e66c --- /dev/null +++ b/collects/scribblings/start/start.scrbl @@ -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)))))) +] diff --git a/collects/setup/scribble.ss b/collects/setup/scribble.ss index 09b6fff84c..c841063a7a 100644 --- a/collects/setup/scribble.ss +++ b/collects/setup/scribble.ss @@ -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")] diff --git a/doc/release-notes/mzscheme/MzScheme_4.txt b/doc/release-notes/mzscheme/MzScheme_4.txt index 662229c020..1aef6804ab 100644 --- a/doc/release-notes/mzscheme/MzScheme_4.txt +++ b/doc/release-notes/mzscheme/MzScheme_4.txt @@ -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 ======================================================================