add start document

svn: r7708
This commit is contained in:
Matthew Flatt 2007-11-13 13:28:43 +00:00
parent 39cedb62ed
commit 048c12100d
4 changed files with 58 additions and 6 deletions

View File

@ -0,0 +1,3 @@
(module info setup/infotab
(define name "Scribblings: Start")
(define scribblings '(("start.scrbl" (main-doc)))))

View 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))))))
]

View File

@ -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")]

View File

@ -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
======================================================================