From 9ed66c31f244fb19cd00a1d09a7af2c81fbe7cbe Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Sun, 18 Nov 2012 10:30:18 -0700 Subject: [PATCH] racket/gui: fix docs for `printer-dc%' and related functions A page-setup dialog is now available on all platforms, which means that no dialog will appear when a `pirinter-dc%' is created. Meanwhile, note that `end-doc' normally shows a (different) dialog. original commit: 843aa670e96fe34f1b2426ba76f7cc44ceefb867 --- collects/scribblings/gui/dialog-funcs.scrbl | 9 +++------ collects/scribblings/gui/printer-dc-class.scrbl | 11 +++++------ 2 files changed, 8 insertions(+), 12 deletions(-) diff --git a/collects/scribblings/gui/dialog-funcs.scrbl b/collects/scribblings/gui/dialog-funcs.scrbl index 08d54765..da048821 100644 --- a/collects/scribblings/gui/dialog-funcs.scrbl +++ b/collects/scribblings/gui/dialog-funcs.scrbl @@ -540,11 +540,8 @@ The result is @racket[#f] if the user cancels the dialog, a @defproc[(can-get-page-setup-from-user?) boolean?]{ -Returns @racket[#t] if the current platform (Mac OS X) supports a - page-layout dialog for use with @racket[printer-dc%] printing, and - if the page-layout dialog is different from the print-job dialog that - is automatically shown when a @racket[printer-dc%] is - created. Returns @racket[#f] if no separate page-layout dialog is - needed (Windows and Unix). +Returns @racket[#t] if the current platform supports a + page-layout dialog for use with @racket[printer-dc%] printing. + Currently, all platforms support a page-layout dialog. } diff --git a/collects/scribblings/gui/printer-dc-class.scrbl b/collects/scribblings/gui/printer-dc-class.scrbl index 0fb23983..196cfc31 100644 --- a/collects/scribblings/gui/printer-dc-class.scrbl +++ b/collects/scribblings/gui/printer-dc-class.scrbl @@ -15,15 +15,14 @@ A @racket[printer-dc%] object is a printer device context. A newly See also @racket[post-script-dc%]. -When a @racket[printer-dc%] object is created, the user gets - platform-specific modal dialogs for configuring the output. - If the user cancels the dialog, the @method[dc<%> ok?] method - of the object returns @racket[#f]. +When the @method[dc<%> end-doc] method is called on a + @racket[printer-dc%] instance, the user may receive a dialog + to determine how the document is printed. @defconstructor[([parent (or/c (is-a?/c frame%) (is-a?/c dialog%) #f) #f])]{ -If @racket[parent] is not @racket[#f], it is used as the parent window - of the configuration dialog. +If @racket[parent] is not @racket[#f], it is may be as the parent window + of the dialog (if any) presented by @method[dc<%> end-doc]. }}