From fd2136071a4f805909d0ad3e431209e7ca6ad012 Mon Sep 17 00:00:00 2001
From: Matthew Flatt <mflatt@racket-lang.org>
Date: Wed, 14 Jan 2009 22:45:46 +0000
Subject: [PATCH] document 'help' change

svn: r13128
---
 collects/scribblings/reference/help.scrbl | 23 +++++++++++++++++------
 collects/scribblings/reference/mz.ss      |  2 +-
 2 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/collects/scribblings/reference/help.scrbl b/collects/scribblings/reference/help.scrbl
index b98f6f070f..57f4efb19e 100644
--- a/collects/scribblings/reference/help.scrbl
+++ b/collects/scribblings/reference/help.scrbl
@@ -19,6 +19,7 @@
 
 @deftogether[(
 @defidform[help]
+@defform/none[#:literals (help) (help string ...)]
 @defform/none[#:literals (help) (help id)]
 @defform/none[#:literals (help) (help id #:from module-path)]
 @defform/none[#:literals (help) (help #:search datum ...)]
@@ -35,6 +36,17 @@ the user's browser is launched to display help information.}
 A simple @scheme[help] or @scheme[(help)] form opens the main
 documentation page.
 
+The @scheme[(help string ...)] form---using literal strings, as
+opposed to expressions that produce strings---performs a
+string-matching search. For example,
+
+@schemeblock[
+(help "web browser" "firefox")
+]
+
+searches the documentation index for references that include the
+phrase ``web browser'' or ``firefox.''
+
 A @scheme[(help id)] form looks for documentation specific to the
 current binding of @scheme[id]. For example, 
 
@@ -70,11 +82,10 @@ The @scheme[(help id #:from module-path)] variant is similar to
 (help frame% #:from scheme/gui) (code:comment #, @t{equivalent to the above})
 ]
 
-The @scheme[(help #:search datum ...)] form performs a general
-search. Searching uses strings; each string @scheme[datum] is used
-as-is, and any other form of @scheme[datum] is converted to a string
-using @scheme[display]. No @scheme[datum] is evaluated as an
-expression.
+The @scheme[(help #:search datum ...)] form is similar to
+@scheme[(help string ...)], where any non-string form of
+@scheme[datum] is converted to a string using @scheme[display]. No
+@scheme[datum] is evaluated as an expression.
 
 For example,
 
@@ -82,7 +93,7 @@ For example,
 (help #:search "web browser" firefox)
 ]
 
-searches the documentation index for references that include the
+also searches the documentation index for references that include the
 phrase ``web browser'' or ``firefox.''
 
 }
diff --git a/collects/scribblings/reference/mz.ss b/collects/scribblings/reference/mz.ss
index 3d6230d69f..9eb2124533 100644
--- a/collects/scribblings/reference/mz.ss
+++ b/collects/scribblings/reference/mz.ss
@@ -57,7 +57,7 @@
               (schememodname lib)
               " and "
               (schememodname scheme/init)
-              " libraries, which means that they ara available when "
+              " libraries, which means that they are available when "
               (exec "mzscheme") " is started with no command-line arguments."
               " They are not provided by " (schememodname scheme/base)
               " or " (schememodname scheme) "."