From a7064d5f6ae6ac941df16f377dbbabdbbbc75865 Mon Sep 17 00:00:00 2001 From: Eli Barzilay Date: Thu, 14 Jun 2012 16:58:04 -0400 Subject: [PATCH] A bunch of typo fixes from Richard Cleis. --- collects/plot/scribblings/compat.scrbl | 4 ++-- collects/rackunit/scribblings/compound-testing.scrbl | 3 +-- .../guide/contracts-general-function.scrbl | 2 +- collects/scribblings/guide/contracts-gotchas.scrbl | 8 ++++---- .../guide/contracts-simple-function.scrbl | 2 +- collects/scribblings/guide/dialects.scrbl | 4 ++-- collects/scribblings/guide/for.scrbl | 2 +- collects/scribblings/guide/let.scrbl | 2 +- collects/scribblings/guide/module-basics.scrbl | 4 ++-- collects/scribblings/guide/named-let.scrbl | 2 +- collects/scribblings/guide/pattern-macros.scrbl | 12 ++++++------ collects/scribblings/guide/proc-macros.scrbl | 2 +- collects/scribblings/guide/reader-extension.scrbl | 6 +++--- collects/scribblings/guide/regexp.scrbl | 2 +- collects/scribblings/guide/syntax-taints.scrbl | 2 +- collects/scribblings/guide/truth.scrbl | 2 +- collects/scribblings/guide/unit.scrbl | 4 ++-- collects/scribblings/reference/eval-model.scrbl | 2 +- collects/scribblings/reference/syntax.scrbl | 2 +- 19 files changed, 33 insertions(+), 34 deletions(-) diff --git a/collects/plot/scribblings/compat.scrbl b/collects/plot/scribblings/compat.scrbl index 07cac36fba..295f160751 100644 --- a/collects/plot/scribblings/compat.scrbl +++ b/collects/plot/scribblings/compat.scrbl @@ -139,10 +139,10 @@ calculation.} @defproc[(gradient [f (real? real? . -> . real?)] [h real? .000001]) ((vector/c real? real?) . -> . (vector/c real? real?))]{ -Creates a vector-valued function that the numeric gradient of +Creates a vector-valued function that computes the numeric gradient of @racket[f].} @defproc[(make-vec [fx (real? real? . -> . real?)] [fy (real? real? . -> . real?)]) ((vector/c real? real?) . -> . (vector/c real? real?))]{ -Creates a vector-values function from two parts.} +Creates a vector-valued function from two parts.} diff --git a/collects/rackunit/scribblings/compound-testing.scrbl b/collects/rackunit/scribblings/compound-testing.scrbl index 66184543ad..6b9acc8fc6 100644 --- a/collects/rackunit/scribblings/compound-testing.scrbl +++ b/collects/rackunit/scribblings/compound-testing.scrbl @@ -161,7 +161,7 @@ the name @racket["example-suite"]: ] @defform[(define/provide-test-suite name test ...)]{ This -for is just like @racket[define-test-suite], and in addition +form is just like @racket[define-test-suite], and in addition it @racket[provide]s the test suite.} @;{ @@ -177,4 +177,3 @@ body expressions. As far I know no-one uses this macro, so it might disappear in future versions of RackUnit.} } - diff --git a/collects/scribblings/guide/contracts-general-function.scrbl b/collects/scribblings/guide/contracts-general-function.scrbl index 6d15afbea1..04677428aa 100644 --- a/collects/scribblings/guide/contracts-general-function.scrbl +++ b/collects/scribblings/guide/contracts-general-function.scrbl @@ -297,7 +297,7 @@ and make them more accessible to potential clients. Going back to the bank-account example, suppose that we generalize the module to support multiple accounts and that we also include a -withdrawal operation. The improved bank-account module includes a +withdrawal operation. The improved bank-account module includes an @racket[account] structure type and the following functions: @racketblock[ diff --git a/collects/scribblings/guide/contracts-gotchas.scrbl b/collects/scribblings/guide/contracts-gotchas.scrbl index 87b8c83de1..e3cd51e7c7 100644 --- a/collects/scribblings/guide/contracts-gotchas.scrbl +++ b/collects/scribblings/guide/contracts-gotchas.scrbl @@ -59,14 +59,14 @@ Specifically, the @racket[null?] predicate (and many other predicates) return @racket[#f] for @racket[#:∃] contracts, and changing one of those contracts to @racket[any/c] means that @racket[null?] might now return @racket[#t] instead, resulting in -arbitrarily different behavior depending on this boolean might flow around +arbitrarily different behavior depending on how this boolean might flow around in the program. @defmodulelang[racket/exists] To work around the above problem, the -@racketmodname[racket/exists] library behaves just like the @racketmodname[racket], -but where predicates signal errors when given @racket[#:∃] contracts. +@racketmodname[racket/exists] library behaves just like @racketmodname[racket], +but predicates signal errors when given @racket[#:∃] contracts. Moral: Do not use predicates on @racket[#:∃] contracts, but if you're not sure, use @racketmodname[racket/exists] to be safe. @@ -90,7 +90,7 @@ streams like this: Unfortunately, this does not work because the value of @racket[stream/c] is needed before it is defined. Put another way, all -of the combinators evaluate their arguments eagerly, even thought the +of the combinators evaluate their arguments eagerly, even though the values that they accept do not. Instead, use diff --git a/collects/scribblings/guide/contracts-simple-function.scrbl b/collects/scribblings/guide/contracts-simple-function.scrbl index d2ab6ecad9..242388cb4f 100644 --- a/collects/scribblings/guide/contracts-simple-function.scrbl +++ b/collects/scribblings/guide/contracts-simple-function.scrbl @@ -124,7 +124,7 @@ that the function produces a single value. That is, @racketblock[(-> integer? any)] -describes a function that accepts and integer and returns any number of +describes a function that accepts an integer and returns any number of values, while @racketblock[(-> integer? any/c)] diff --git a/collects/scribblings/guide/dialects.scrbl b/collects/scribblings/guide/dialects.scrbl index e9a8b5db2d..b9fd2b0ce0 100644 --- a/collects/scribblings/guide/dialects.scrbl +++ b/collects/scribblings/guide/dialects.scrbl @@ -1,12 +1,12 @@ #lang scribble/base -@(require scribble/manual +@(require scribble/manual "guide-utils.rkt") @title[#:tag "dialects" #:style 'toc]{Dialects of Racket and Scheme} We use ``Racket'' to refer to a specific dialect of the Lisp language, and one that is based on the Scheme branch of the Lisp family. -Despite Racket's similarly to Scheme, the @hash-lang[] prefix on +Despite Racket's similarity to Scheme, the @hash-lang[] prefix on modules is a particular feature of Racket, and programs that start with @hash-lang[] are unlikely to run in other implementations of Scheme. At the same time, programs that do not start with @hash-lang[] diff --git a/collects/scribblings/guide/for.scrbl b/collects/scribblings/guide/for.scrbl index 272915f303..58421bedb6 100644 --- a/collects/scribblings/guide/for.scrbl +++ b/collects/scribblings/guide/for.scrbl @@ -393,7 +393,7 @@ multiple identifiers, @racket[for] can bind multiple sequence elements to multiple iteration identifiers: @margin-note{While @racket[let] must be changed to @racket[let-values] - to bind multiple identifier, @racket[for] simply allows a + to bind multiple identifiers, @racket[for] simply allows a parenthesized list of identifiers instead of a single identifier in any clause.} diff --git a/collects/scribblings/guide/let.scrbl b/collects/scribblings/guide/let.scrbl index 0ccb82a568..bd41220d34 100644 --- a/collects/scribblings/guide/let.scrbl +++ b/collects/scribblings/guide/let.scrbl @@ -148,7 +148,7 @@ While the @racket[_expr]s of a @racket[letrec] form are typically expressions are evaluated in order, and after each value is obtained, it is immediately associated with its corresponding @racket[_id]. If an @racket[_id] is referenced before its value is ready, the result is -@|undefined-const|, as just as for internal definitions. +@|undefined-const|, just as for internal definitions. @interaction[ (letrec ([quicksand quicksand]) diff --git a/collects/scribblings/guide/module-basics.scrbl b/collects/scribblings/guide/module-basics.scrbl index e925b1a1fc..d387dc84cb 100644 --- a/collects/scribblings/guide/module-basics.scrbl +++ b/collects/scribblings/guide/module-basics.scrbl @@ -214,7 +214,7 @@ sense. In that case, you have two options: unquoted path, just like libraries that are included with the Racket distribution.} - @item{Add the library a new or existing @|PLaneT| package. Libraries + @item{Add the library to a new or existing @|PLaneT| package. Libraries in a @|PLaneT| package are referenced with a path of the form @racket[(planet ....)] path. @margin-note*{See @other-doc['(lib "planet/planet.scrbl")] @@ -269,7 +269,7 @@ top-level name like @filepath{molly} that identifies the producer. Use a collection name like @filepath{bakery} when producing the definitive collection of baked-goods libraries. -After your libraries are in a @tech{collection}, then you can still +After your libraries are put in a @tech{collection} you can still use @exec{raco make} to compile the library sources, but it's better and more convenient to use @exec{raco setup}. The @exec{raco setup} command takes a collection name (as opposed to a file name) and diff --git a/collects/scribblings/guide/named-let.scrbl b/collects/scribblings/guide/named-let.scrbl index d5184b6fbd..3cc6ca9ebd 100644 --- a/collects/scribblings/guide/named-let.scrbl +++ b/collects/scribblings/guide/named-let.scrbl @@ -8,7 +8,7 @@ same syntactic keyword @racket[let] as for local binding, but an identifier after the @racket[let] (instead of an immediate open parenthesis) triggers a different parsing. -@specform[ +@racketblock[ (let _proc-id ([_arg-id _init-expr] ...) _body ...+) ] diff --git a/collects/scribblings/guide/pattern-macros.scrbl b/collects/scribblings/guide/pattern-macros.scrbl index 67761735df..10be33a49f 100644 --- a/collects/scribblings/guide/pattern-macros.scrbl +++ b/collects/scribblings/guide/pattern-macros.scrbl @@ -362,24 +362,24 @@ above, we'll generate and redirect a function call @racket[(f x y)] to @racketblock[ -(do-f (lambda () x) +(do-f (lambda () x) (lambda () y) - (lambda (v) (set! x v)) + (lambda (v) (set! x v)) (lambda (v) (set! y v))) ] Clearly, then @racket[define-cbr] is a macro-generating macro, which binds @racket[f] to a macro that expands to a call of @racket[do-f]. -That is, @racket[(define-cbr (f a b) (swap ab))] needs to generate the +That is, @racket[(define-cbr (f a b) (swap a b))] needs to generate the definition @racketblock[ (define-syntax f (syntax-rules () [(id actual ...) - (do-f (lambda () actual) + (do-f (lambda () actual) ... - (lambda (v) + (lambda (v) (set! actual v)) ...)])) ] @@ -415,7 +415,7 @@ converts to the function definition @racket[do-f] above. Most of the work is generating a @racket[define-get/put-id] declaration for each argument, -@racket[a] ad @racket[b], and putting them before the body. Normally, +@racket[a] and @racket[b], and putting them before the body. Normally, that's an easy task for @racket[...] in a pattern and template, but this time there's a catch: we need to generate the names @racket[get-a] and @racket[put-a!] as well as @racket[get-b] and diff --git a/collects/scribblings/guide/proc-macros.scrbl b/collects/scribblings/guide/proc-macros.scrbl index 55d347f093..c3290c0abf 100644 --- a/collects/scribblings/guide/proc-macros.scrbl +++ b/collects/scribblings/guide/proc-macros.scrbl @@ -30,7 +30,7 @@ procedure: Instead of using @racket[syntax-rules], you can write your own macro transformer procedure directly using @racket[lambda]. The argument to -the procedure is a values that represents the source form, and the +the procedure is a value that represents the source form, and the result of the procedure must be a value that represents the replacement form. diff --git a/collects/scribblings/guide/reader-extension.scrbl b/collects/scribblings/guide/reader-extension.scrbl index ccca18c1b0..a48141bef3 100644 --- a/collects/scribblings/guide/reader-extension.scrbl +++ b/collects/scribblings/guide/reader-extension.scrbl @@ -165,7 +165,7 @@ specifications in terms of a character, a type of mapping for the character, and (for certain types of mappings) a parsing procedure. For example, to extend the readtable so that @litchar{$} can be used to start and end infix expressions, implement a -@racket[parse-dollar] function and use: +@racket[read-dollar] function and use: @racketblock[ (make-readtable (current-readtable) @@ -182,9 +182,9 @@ additional arguments that provide the source location of the character. The following @filepath{dollar.rkt} module defines a -@racket[parse-dollar] function in terms of the @racketidfont{read} and +@racket[read-dollar] function in terms of the @racketidfont{read} and @racketidfont{read-syntax} functions provided by @filepath{arith.rkt}, -and it puts @racket[parse-dollar] together with new @racketidfont{read} and +and it puts @racket[read-dollar] together with new @racketidfont{read} and @racketidfont{read-syntax} functions that install the readtable and chain to Racket's @racket[read] or @racket[read-syntax]: diff --git a/collects/scribblings/guide/regexp.scrbl b/collects/scribblings/guide/regexp.scrbl index de74e303b1..3376883a18 100644 --- a/collects/scribblings/guide/regexp.scrbl +++ b/collects/scribblings/guide/regexp.scrbl @@ -557,7 +557,7 @@ refer back to an already matched subpattern in the pattern. @litchar{\}@math{n} stands for an exact repeat of the @math{n}th submatch. Note that @litchar{\0}, which is useful in an insert string, makes no sense within the regexp pattern, because the entire regexp -has not matched yet that you could refer back to it.} +has not matched yet so you cannot refer back to it.} @interaction[ (regexp-match #px"([a-z]+) and \\1" diff --git a/collects/scribblings/guide/syntax-taints.scrbl b/collects/scribblings/guide/syntax-taints.scrbl index 13f473d304..9bcea1ab8e 100644 --- a/collects/scribblings/guide/syntax-taints.scrbl +++ b/collects/scribblings/guide/syntax-taints.scrbl @@ -60,7 +60,7 @@ with a @deftech{dye pack}. When a syntax object is armed, then @racket[syntax-e] taints any syntax object in its result. Similarly, @racket[datum->syntax] taints its result when its first argument is armed. Finally, if any part of a quoted syntax object is armed, then -the corresponding part is tainted the resulting syntax constant. +the corresponding part taints the resulting syntax constant. Of course, the macro expander itself must be able to @deftech{disarm} a taint on a syntax object, so that it can further expand an diff --git a/collects/scribblings/guide/truth.scrbl b/collects/scribblings/guide/truth.scrbl index 753e560e35..8b2f3fa1f3 100644 --- a/collects/scribblings/guide/truth.scrbl +++ b/collects/scribblings/guide/truth.scrbl @@ -81,7 +81,7 @@ is itself a list, then no quote mark is printed for the inner list: ] For nested lists, especially, the @racket[quote] form lets you write a -list as an expression in essentially the same way that the list it +list as an expression in essentially the same way that the list prints: @interaction[ diff --git a/collects/scribblings/guide/unit.scrbl b/collects/scribblings/guide/unit.scrbl index 7f7ce014da..e4acda5e5a 100644 --- a/collects/scribblings/guide/unit.scrbl +++ b/collects/scribblings/guide/unit.scrbl @@ -589,12 +589,12 @@ As a form for modularity, @racket[unit] complements @racket[module]: @racketmodname[racket/base]---the one that extracts the first element of an instance of the built-in pair datatype---as opposed to any number of other functions with the name - @racket[car]. In other word, the @racket[module] construct lets + @racket[car]. In other words, the @racket[module] construct lets you refer to @emph{the} binding that you want.} @item{The @racket[unit] form is for parameterizing a code fragment with respect to most any kind of run-time value. For example, - it allows a code fragment for work with a @racket[car] + it allows a code fragment to work with a @racket[car] function that accepts a single argument, where the specific function is determined later by linking the fragment to another. In other words, the @racket[unit] construct lets you diff --git a/collects/scribblings/reference/eval-model.scrbl b/collects/scribblings/reference/eval-model.scrbl index 368fc63209..57911f0d8b 100644 --- a/collects/scribblings/reference/eval-model.scrbl +++ b/collects/scribblings/reference/eval-model.scrbl @@ -502,7 +502,7 @@ both @racket[y] and @racket[x] are @tech{variables}. The @racket[y] a @tech{local variable}. When this code is evaluated, a @tech{location} is created for @racket[x] to hold the value @racket[5], and a @tech{location} is also created for @racket[y] to -hold the value @racket[6]. +hold the value @racket[11]. The replacement of a @tech{variable} with a @tech{location} during evaluation implements Racket's @deftech{lexical scoping}. For example, diff --git a/collects/scribblings/reference/syntax.scrbl b/collects/scribblings/reference/syntax.scrbl index fb45a27060..be90676988 100644 --- a/collects/scribblings/reference/syntax.scrbl +++ b/collects/scribblings/reference/syntax.scrbl @@ -2544,7 +2544,7 @@ by @racket[make-rename-transformer] or as an instance of a structure type with the @racket[prop:rename-transformer] property, then this form is expanded by replacing @racket[id] with the target identifier (e.g., the one provided to @racket[make-rename-transformer]). If a -transformer binding has both @racket[prop:set!-transformer] ad +transformer binding has both @racket[prop:set!-transformer] and @racket[prop:rename-transformer] properties, the latter takes precedence.