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
This commit is contained in:
Matthew Flatt 2012-11-18 10:30:18 -07:00
parent 80950cd990
commit 9ed66c31f2
2 changed files with 8 additions and 12 deletions

View File

@ -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.
}

View File

@ -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].
}}