diff --git a/collects/mrlib/scribblings/path-dialog.scrbl b/collects/mrlib/scribblings/path-dialog.scrbl
index 0ab2690b71..11b72fd17d 100644
--- a/collects/mrlib/scribblings/path-dialog.scrbl
+++ b/collects/mrlib/scribblings/path-dialog.scrbl
@@ -9,10 +9,10 @@
 @defclass[path-dialog% dialog% ()]{
 
 The @scheme[path-dialog%] class implements a platform-independent
-file/directory dialog.  The dialog is the same as the dialog under X
-for the @scheme[get-file], @scheme[put-file], @scheme[get-directory],
-and @scheme[get-file-list] procedures, but considerable extra
-functionality is available through the @scheme[path-dialog%] class.
+file/directory dialog.  The dialog is similar in functionality to the
+@scheme[get-file], @scheme[put-file], @scheme[get-directory], and
+@scheme[get-file-list] procedures, but considerable extra functionality
+is available through the @scheme[path-dialog%] class.
 
 
 @defconstructor[([label (or/c label-string? false/c) #f]
diff --git a/collects/scribblings/gui/dialog-funcs.scrbl b/collects/scribblings/gui/dialog-funcs.scrbl
index 65d477a010..59faefd338 100644
--- a/collects/scribblings/gui/dialog-funcs.scrbl
+++ b/collects/scribblings/gui/dialog-funcs.scrbl
@@ -57,7 +57,14 @@ Under Windows and X, @scheme[filters] determines a set of filters from
  which the user can choose in the dialog. Each element of the
  @scheme[filters] list contains two strings: a description of the filter
  as seen by the user, and a filter pattern matched against file names.
+ Pattern strings can be a simple ``glob'' pattern, or a number of glob
+ patterns separated by a @litchar[";"] character.
  Under X, a @racket["*.*"] pattern is implicitly replaced with @racket["*"].
+ Under Mac OS X, suffix names are extracted from all globs that match a
+ fixed suffix (e.g., two suffixes of @racket["foo"] and @racket["bar"]
+ are extracted from a @racket["*.foo;*.bar;*.baz*"] pattern), and files
+ that have any of these suffixes in any filter are selectable; a
+ @racket["*.*"] glob makes all files available for selection.
 
 See also @scheme[path-dialog%].