add cross-references from model section to function sections

svn: r12502
This commit is contained in:
Matthew Flatt 2008-11-18 23:33:29 +00:00
parent f81826e792
commit f66e852163
3 changed files with 21 additions and 1 deletions

View File

@ -339,6 +339,9 @@ specified with the datatype and its associated procedures.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "gc-model"]{Garbage Collection} @section[#:tag "gc-model"]{Garbage Collection}
@margin-note/ref{See @secref["memory"] for functions related to
garbage collection.}
In the program state In the program state
@prog-steps[ @prog-steps[
@ -504,6 +507,8 @@ access the same @tech{location}.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "module-eval-model"]{Modules and Module-Level Variables} @section[#:tag "module-eval-model"]{Modules and Module-Level Variables}
@margin-note/ref{See @secref["module"] for the syntax of modules.}
Most definitions in PLT Scheme are in modules. In terms of evaluation, Most definitions in PLT Scheme are in modules. In terms of evaluation,
a module is essentially a prefix on a defined name, so that different a module is essentially a prefix on a defined name, so that different
modules can define the name. That is, a @deftech{module-level modules can define the name. That is, a @deftech{module-level
@ -599,6 +604,8 @@ re-declared, each re-declaration of the module is immediately
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "mark-model"]{Continuation Frames and Marks} @section[#:tag "mark-model"]{Continuation Frames and Marks}
@margin-note/ref{See @secref["contmarks"] for continuation-mark forms and functions.}
Every continuation @scheme[_C] can be partitioned into Every continuation @scheme[_C] can be partitioned into
@deftech{continuation frames} @frame[1], @frame[2], ..., @frame["n"] @deftech{continuation frames} @frame[1], @frame[2], ..., @frame["n"]
such that @scheme[_C] = @*sub[@frame[1] @*sub[@frame[2] @*sub["..." such that @scheme[_C] = @*sub[@frame[1] @*sub[@frame[2] @*sub["..."
@ -618,6 +625,8 @@ to implement dynamic scope.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "prompt-model"]{Prompts, Delimited Continuations, and Barriers} @section[#:tag "prompt-model"]{Prompts, Delimited Continuations, and Barriers}
@margin-note/ref{See @secref["cont"] for continuation and prompt functions.}
A @deftech{prompt} is a special kind of continuation frame that is A @deftech{prompt} is a special kind of continuation frame that is
annotated with a specific @deftech{prompt tag} (essentially a annotated with a specific @deftech{prompt tag} (essentially a
continuation mark). Various operations allow the capture of frames in continuation mark). Various operations allow the capture of frames in
@ -650,6 +659,8 @@ escape-continuation aborts can cross continuation barriers.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "thread-model"]{Threads} @section[#:tag "thread-model"]{Threads}
@margin-note/ref{See @secref["concurrency"] for thread and synchronization functions.}
Scheme supports multiple @deftech{threads} of evaluation. Threads run Scheme supports multiple @deftech{threads} of evaluation. Threads run
concurrently, in the sense that one thread can preempt another without concurrently, in the sense that one thread can preempt another without
its cooperation, but threads currently all run on the same processor its cooperation, but threads currently all run on the same processor
@ -677,6 +688,8 @@ is created) as all other threads.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "parameter-model"]{Parameters} @section[#:tag "parameter-model"]{Parameters}
@margin-note/ref{See @secref["parameters"] for parameter forms and functions.}
@deftech{Parameters} are essentially a derived concept in Scheme; they @deftech{Parameters} are essentially a derived concept in Scheme; they
are defined in terms of @tech{continuation marks} and @tech{thread are defined in terms of @tech{continuation marks} and @tech{thread
cells}. However, parameters are also built in, in the sense that some cells}. However, parameters are also built in, in the sense that some
@ -705,6 +718,8 @@ the current continuation's frame.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "exn-model"]{Exceptions} @section[#:tag "exn-model"]{Exceptions}
@margin-note/ref{See @secref["exns"] for exception forms, functions, and types.}
@deftech{Exceptions} are essentially a derived concept in Scheme; they @deftech{Exceptions} are essentially a derived concept in Scheme; they
are defined in terms of continuations, prompts, and continuation are defined in terms of continuations, prompts, and continuation
marks. However, exceptions are also built in, in the sense that marks. However, exceptions are also built in, in the sense that
@ -727,6 +742,8 @@ outermost frame of the continuation for any new thread.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "custodian-model"]{Custodians} @section[#:tag "custodian-model"]{Custodians}
@margin-note/ref{See @secref["custodians"] for custodian functions.}
A @deftech{custodian} manages a collection of threads, file-stream A @deftech{custodian} manages a collection of threads, file-stream
ports, TCP ports, TCP listeners, UDP sockets, and byte converters. ports, TCP ports, TCP listeners, UDP sockets, and byte converters.
Whenever a thread, file-stream port, TCP port, TCP listener, or UDP Whenever a thread, file-stream port, TCP port, TCP listener, or UDP

View File

@ -1,7 +1,7 @@
#lang scribble/doc #lang scribble/doc
@(require "mz.ss") @(require "mz.ss")
@title{Namespaces} @title[#:tag "Namespaces"]{Namespaces}
See @secref["namespace-model"] for basic information on the See @secref["namespace-model"] for basic information on the
@tech{namespace} model. @tech{namespace} model.

View File

@ -682,6 +682,9 @@ it, compiles it, and evaluates it.
@;------------------------------------------------------------------------ @;------------------------------------------------------------------------
@section[#:tag "namespace-model"]{Namespaces} @section[#:tag "namespace-model"]{Namespaces}
@margin-note/ref{See @secref["Namespaces"] for functions that
manipulate namespaces.}
A @deftech{namespace} is a top-level mapping from symbols to binding A @deftech{namespace} is a top-level mapping from symbols to binding
information. It is the starting point for expanding an expression; a information. It is the starting point for expanding an expression; a
@tech{syntax object} produced by @scheme[read-syntax] has no initial @tech{syntax object} produced by @scheme[read-syntax] has no initial