Small typos, some reformatting.

Fixes PR10920
This commit is contained in:
Eli Barzilay 2010-05-21 16:30:16 -04:00
parent 682430b2c4
commit c4f67b3e74
21 changed files with 66 additions and 109 deletions

View File

@ -42,9 +42,8 @@ Returns the size or alignment of a given @scheme[type] for the current
platform.}
@defproc[(ctype->layout [type ctype?]) (flat-rec-contract rep
symbol?
(listof rep))]{
@defproc[(ctype->layout [type ctype?])
(flat-rec-contract rep symbol? (listof rep))]{
Returns a value to describe the eventual C representation of the
type. It can be any of the following symbols:

View File

@ -14,8 +14,7 @@
@title{Miscellaneous}
@defproc[(begin-busy-cursor)
void?]{
@defproc[(begin-busy-cursor) void?]{
Changes the cursor to a watch cursor for all windows in the current eventspace.
Use
@ -27,30 +26,15 @@ The cursor installed by
@scheme[begin-busy-cursor] overrides any window-specific cursors installed with
@method[window<%> set-cursor].
See also
@scheme[is-busy?].
See also @scheme[is-busy?].
}
@defproc[(bell)
void?]{
@defproc[(bell) void?]{
Rings the system bell.
}
@defproc[(end-busy-cursor)
void?]{
See
@scheme[begin-busy-cursor].
@defproc[(end-busy-cursor) void?]{
See @scheme[begin-busy-cursor].
}
@defproc*[([(file-creator-and-type [filename path]
@ -234,12 +218,9 @@ The keymap for the read-eval-print loop's editor is initialized by
calling the current keymap initializer procedure, which is determined
by the
@scheme[current-text-keymap-initializer] parameter.
}
@defproc[(textual-read-eval-print-loop)
void?]{
@defproc[(textual-read-eval-print-loop) void?]{
Similar to @scheme[read-eval-print-loop], except that evaluation uses
a newly created eventspace.
@ -259,30 +240,21 @@ break is sent (via @scheme[break-thread]) to the created eventspace's
@tech{handler thread}.}
@defproc[(hide-cursor-until-moved)
void?]{
@defproc[(hide-cursor-until-moved) void?]{
Hides the cursor until the user moves the mouse or clicks the mouse
button. (For some platforms, the cursor is not hidden if it is over
a window in a different eventspace or application.)
}
@defproc[(is-busy?)
boolean?]{
@defproc[(is-busy?) boolean?]{
Returns @scheme[#t] if a busy cursor has been installed with
@scheme[begin-busy-cursor] and not removed with
@scheme[end-busy-cursor].
}
@defproc[(label->plain-label [label string])
string]{
@defproc[(label->plain-label [label string]) string?]{
Strips shortcut ampersands from @scheme[label], removes parenthesized
ampersand--character combinations along with any surrounding space,
@ -292,15 +264,13 @@ Strips shortcut ampersands from @scheme[label], removes parenthesized
}
@defproc[(make-gui-empty-namespace)
namespace?]{
@defproc[(make-gui-empty-namespace) namespace?]{
Like @scheme[make-base-empty-namespace], but with
@scheme[scheme/class] and @schememodname[scheme/gui/base] also
attached to the result namespace.}
@defproc[(make-gui-namespace)
namespace?]{
@defproc[(make-gui-namespace) namespace?]{
Like @scheme[make-base-namespace], but with @scheme[scheme/class] and
@schememodname[scheme/gui/base] also required into the top-level

View File

@ -1091,7 +1091,6 @@ converted to a path using @racket[bytes->path].}
(or/c (listof bytes?) bytes?)))])
path?]{
The inverse of @racket[path->main-collects-relative]: if @racket[rel]
is a pair that starts with @racket['collects], then it is converted
back to a path relative to @racket[(find-collects-dir)].

View File

@ -48,8 +48,7 @@ positions are initialized with the given @scheme[b]s.
@defproc[(bytes->immutable-bytes [bstr bytes?])
(and/c bytes?
immutable?)]{
(and/c bytes? immutable?)]{
Returns an immutable byte string with the same content
as @scheme[bstr], returning @scheme[bstr] itself if @scheme[bstr] is
immutable.

View File

@ -144,8 +144,7 @@ Returns @racket[#t] if @racket[v] is a mark set created by
@racket[continuation-marks] or @racket[current-continuation-marks],
@racket[#f] otherwise.}
@defproc[(continuation-mark-set->context
[mark-set continuation-mark-set?])
@defproc[(continuation-mark-set->context [mark-set continuation-mark-set?])
list?]{
Returns a list representing an approximate ``@index["stack

View File

@ -79,7 +79,7 @@ used as an ephemeron key (see @secref["ephemerons"]).
(symbol-unreadable? (gensym))
(symbol-unreadable? (string->unreadable-symbol "Apple"))]}
@defproc[(symbol->string [sym symbol?]) symbol?]{Returns a freshly
@defproc[(symbol->string [sym symbol?]) string?]{Returns a freshly
allocated mutable string whose characters are the same as in
@scheme[sym].
@ -150,7 +150,7 @@ Returns @scheme[#t] if @scheme[v] is a keyword, @scheme[#f] otherwise.}
Returns a string for the @scheme[display]ed form of @scheme[keyword],
not including the leading @litchar{#:}.}
@defproc[(string->keyword [str string?]) keyword]{
@defproc[(string->keyword [str string?]) keyword?]{
Returns a keyword whose @scheme[display]ed form is the same as that of
@scheme[str], but with a leading @litchar{#:}.}

View File

@ -146,7 +146,6 @@ by @racket[kind], which must be one of the following:
[default-path-list (listof path?)])
(listof path?)]{
Parses a string or byte string containing a list of paths, and returns
a list of path strings. Under @|AllUnix|, paths in a path list are
separated by a @litchar{:}; under Windows, paths are separated by a
@ -598,7 +597,7 @@ for @racket[open-input-file].}
@defproc[(file->value [path path-string?]
[#:mode mode-flag (or/c 'binary 'text) 'binary])
bytes?]{
any]{
Reads a single S-expression from @racket[path] using @racket[read].
The @racket[mode-flag] argument is the same as for

View File

@ -734,8 +734,8 @@ generator.}
@section-index["numbers" "little-endian"]
@section-index["numbers" "converting"]
@defproc[(number->string [z number?]
[radix (or/c 2 8 10 16) 10]) string?]{
@defproc[(number->string [z number?] [radix (or/c 2 8 10 16) 10])
string?]{
Returns a string that is the printed form of @racket[z]
in the base specific by @racket[radix]. If @racket[z] is inexact,
@racket[radix] must be @racket[10], otherwise the
@ -801,8 +801,7 @@ least-significant eight bits, and so on.}
[size-n (or/c 2 4 8)]
[signed? any/c]
[big-endian? any/c (system-big-endian?)]
[dest-bstr (and/c bytes?
(not/c immutable?))
[dest-bstr (and/c bytes? (not/c immutable?))
(make-bytes size-n)]
[start exact-nonnegative-integer? 0])
bytes?]{
@ -844,8 +843,7 @@ provides the least-significant eight bits, and so on.}
@defproc[(real->floating-point-bytes [x real?]
[size-n (or/c 4 8)]
[big-endian? any/c (system-big-endian?)]
[dest-bstr (and/c bytes?
(not/c immutable?))
[dest-bstr (and/c bytes? (not/c immutable?))
(make-bytes size-n)]
[start exact-nonnegative-integer? 0])
bytes?]{

View File

@ -66,8 +66,7 @@ typically, however, @scheme[name] is not used for reporting errors,
since the procedure name is typically hard-wired into an internal
check.}
@defproc[(procedure->method [proc procedure?])
procedure?]{
@defproc[(procedure->method [proc procedure?]) procedure?]{
Returns a procedure that is like @scheme[proc] except that, when applied
to the wrong number of arguments, the resulting error hides the first

View File

@ -462,11 +462,13 @@ of the generator.
(introspective-generator)
]}
@defproc[(sequence->generator [s sequence?]) (-> any?)]{ Returns a generator
that returns elements from the sequence, @scheme[s], each time the generator
is invoked.}
@defproc[(sequence->generator [s sequence?]) (-> any?)]{
@defproc[(sequence->repeated-generator [s sequence?]) (-> any?)]{ Returns a generator
that returns elements from the sequence, @scheme[s], similar to
@scheme[sequence->generator] but looping over the values in the sequence
when no more values are left.}
Returns a generator that returns elements from the sequence, @scheme[s],
each time the generator is invoked.}
@defproc[(sequence->repeated-generator [s sequence?]) (-> any?)]{
Returns a generator that returns elements from the sequence, @scheme[s],
similar to @scheme[sequence->generator] but looping over the values in
the sequence when no more values are left.}

View File

@ -121,8 +121,7 @@ pair-valued @tech{syntax object} @italic{only} for parentheses in the
source. See @secref["parse-pair"] for more information.}
@defproc[(syntax->list [stx syntax?])
(or/c list? #f)]{
@defproc[(syntax->list [stx syntax?]) (or/c list? #f)]{
Returns a list of @tech{syntax object}s or @scheme[#f]. The result is a list
of @tech{syntax object}s when @scheme[(syntax->datum stx)] would produce a

View File

@ -171,4 +171,3 @@ calculations.}
Converts a Julian number (Scalinger's off-by-one version) into a
string.}

View File

@ -69,14 +69,12 @@ slot is position @racket[0], and the last slot is one less than
Updates the slot @racket[pos] of @racket[vec] to contain @racket[v].}
@defproc[(vector->list [vec vector?])
list?]{
@defproc[(vector->list [vec vector?]) list?]{
Returns a list with the same length and elements as @racket[vec].}
@defproc[(list->vector [lst list?])
vector?]{
@defproc[(list->vector [lst list?]) vector?]{
Returns a mutable vector with the same length and elements as
@racket[lst].}

View File

@ -415,8 +415,7 @@ The tag @racket[t] refers to the content form of
The @tech{decode}d @racket[pre-content] is hyperlinked to @racket[t],
which is normally defined using @racket[elemtag].}
@defproc[(module-path-prefix->string [mod-path module-path?])
string?]{
@defproc[(module-path-prefix->string [mod-path module-path?]) string?]{
Converts a module path to a string by resolving it to a path, and
using @racket[path->main-collects-relative].}

View File

@ -115,8 +115,7 @@ The optional @racket[using-render%] argument is as for
@racket[load-xref].}
@defproc[(xref-tag->index-entry [xref xref?]
[tag tag?])
@defproc[(xref-tag->index-entry [xref xref?] [tag tag?])
(or/c false/c entry?)]{
Extract an @racket[entry] structure that provides addition information

View File

@ -290,4 +290,3 @@ The same as @racket[pict-last], provided for backward compatibility.}
Mainly for backward compatibility: returns @racket[(if bl-pict
(use-last pict (or (pict-last bl-pict) bl-pict)))].}