Skip to content

Commit

Permalink
Make future trace docs point to the right place when discussing gc-info
Browse files Browse the repository at this point in the history
  • Loading branch information
Zoetermeer committed Oct 28, 2012
1 parent 55b358f commit 995af02
Showing 1 changed file with 6 additions and 19 deletions.
25 changes: 6 additions & 19 deletions collects/future-visualizer/scribblings/futures-trace.scrbl
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
#lang scribble/doc
@(require "common.rkt" (for-label racket/future future-visualizer/trace))
@(require "common.rkt"
(for-label racket/future
future-visualizer/trace))

@title[#:tag "futures-trace"]{Futures Tracing}

Expand Down Expand Up @@ -63,10 +65,11 @@ the execution of parallel programs written using @racket[future].
}

@defstruct[indexed-future-event ([index exact-nonnegative-integer?]
[event (or future-event? gc-info?)])]{
[event any])]{
Represents an individual log message in a program trace. In addition to
future events, the tracing code also records garbage collection events; hence
the @racket[event] field may contain either a @racket[future-event] or @racket[gc-info],
the @racket[event] field may contain either a @racket[future-event] or gc-info
@(tech "prefab" #:doc '(lib "scribblings/reference/reference.scrbl")) struct (see @refsecref["garbagecollection"]),
where the latter describes a GC operation. Because multiple
@racket[future-event] structures may contain identical timestamps, the
@racket[index] field ranks them in the order in which they were recorded
Expand All @@ -82,19 +85,3 @@ the execution of parallel programs written using @racket[future].
#:prefab]{
Represents a future event as logged by the run-time system. See
@refsecref["future-logging"] for more information.}

@defstruct[gc-info ([major? boolean?]
[pre-used integer?]
[pre-admin integer?]
[code-page-total integer?]
[post-used integer?]
[post-admin integer?]
[start-time integer?]
[end-time integer?]
[start-real-time real?]
[end-real-time real?])
#:prefab]{
Represents a garbage collection. The only fields used by the visualizer
are @racket[start-real-time] and @racket[end-real-time], which are inexact
numbers representing time in the same way as @racket[current-inexact-milliseconds].
}

0 comments on commit 995af02

Please sign in to comment.