diff --git a/collects/browser/browser.scrbl b/collects/browser/browser.scrbl index f1f7fd52b4..ddc8112a0b 100644 --- a/collects/browser/browser.scrbl +++ b/collects/browser/browser.scrbl @@ -32,7 +32,8 @@ launching an external browser (such as Firefox). @section[#:tag "browser"]{Browser} -@defmodule[browser] +@defmodule*/no-declare[(browser)] +@declare-exporting[browser/browser browser] The browser supports basic HTML commands, plus special Racket hyperlinks of the form @litchar{...}. When the user clicks @@ -99,12 +100,7 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a @; ---------------------------------------------------------------------- -@defmixin[hyper-frame-mixin (frame%) ()]{ - - @defconstructor/auto-super[([url (or/c url? string? input-port?)])]{ - Shows the frame and visits @racket[url]. - } - +@definterface[hyper-frame<%> ()]{ @defmethod[(get-hyper-panel%) (subclass?/c panel%)]{ Returns the class that is instantiated when the frame is created. Must be a panel with hyper-panel-mixin mixed in. Defaults to just @@ -118,6 +114,16 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a @; ---------------------------------------------------------------------- +@defmixin[hyper-frame-mixin (frame%) (hyper-frame<%>)]{ + + @defconstructor/auto-super[([url (or/c url? string? input-port?)])]{ + Shows the frame and visits @racket[url]. + } + +} + +@; ---------------------------------------------------------------------- + @defclass[hyper-no-show-frame% (hyper-frame-mixin (frame:status-line-mixin frame:basic%)) ()] @@ -137,7 +143,15 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a @; ---------------------------------------------------------------------- -@defmixin[hyper-text-mixin (text%) ()]{ +@definterface[hyper-text<%> ()]{ + @defmethod[(url-allows-evalling? [url (or/c port? url?)]) boolean?]{ + Determines if @litchar{MZSCHEME} annotations are actually evaluated, + for a given url. + } +} +@; ---------------------------------------------------------------------- + +@defmixin[hyper-text-mixin (text%) (hyper-text<%>)]{ An instance of a @racket[hyper-text-mixin]-extended class should be displayed only in an instance of a class created with @@ -257,6 +271,9 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a } +@defclass[hyper-canvas% (hyper-canvas-mixin canvas:basic%) ()]{} + + @; ---------------------------------------------------------------------- @defclass[hyper-text% (hyper-text-mixin text:keymap%) ()]{ @@ -328,7 +345,12 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a @; ---------------------------------------------------------------------- -@defmixin[hyper-panel-mixin (area-container<%>) ()]{ +@definterface[hyper-panel<%> ()]{ +} + +@; ---------------------------------------------------------------------- + +@defmixin[hyper-panel-mixin (area-container<%>) (hyper-panel<%>)]{ @defconstructor/auto-super[([info-line? any/c])]{ Creates controls and a hyper text canvas. The controls permit a @@ -442,6 +464,16 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a } } +@defstruct[(exn:cancelled exn) ()]{ + This exception may be raised by the + @method[hyper-text-mixin reload] method. +} + +@defstruct[(exn:file-saved-instead exn) ([pathname path-string?])]{ + This exception may be raised by the + @method[hyper-text-mixin reload] method. +} + @; ---------------------------------------------------------------------- @section[#:tag "browser-unit"]{Browser Unit} diff --git a/collects/browser/tests/test-docs-complete.rkt b/collects/browser/tests/test-docs-complete.rkt index 7e129f8391..69013ddbdb 100644 --- a/collects/browser/tests/test-docs-complete.rkt +++ b/collects/browser/tests/test-docs-complete.rkt @@ -3,7 +3,7 @@ (check-docs (quote browser)) (check-docs (quote browser/htmltext)) (check-docs (quote browser/external)) -(check-docs (quote browser/bullet-snip)) +(check-docs (quote browser/bullet-snip) #:skip '(snip-class)) (check-docs (quote browser/browser)) (check-docs (quote browser/browser-unit)) (check-docs (quote browser/browser-sig)) diff --git a/collects/compiler/compiler-unit.rkt b/collects/compiler/compiler-unit.rkt index 3912d73b58..1c1d67fc03 100644 --- a/collects/compiler/compiler-unit.rkt +++ b/collects/compiler/compiler-unit.rkt @@ -201,9 +201,11 @@ (define (compile-directory dir info #:verbose [verbose? #t] #:skip-path [orig-skip-path #f] - #:skip-doc-sources? [skip-docs? #f]) + #:skip-doc-sources? [skip-docs? #f] + #:managed-compile-zo [managed-compile-zo + (make-caching-managed-compile-zo)]) (define (worker prev sses) - (for-each (make-caching-managed-compile-zo) sses)) + (for-each managed-compile-zo sses)) (compile-directory-visitor dir info worker #:verbose verbose? #:skip-path orig-skip-path @@ -212,21 +214,27 @@ (define (get-compile-directory-srcs dir info #:verbose [verbose? #t] #:skip-path [orig-skip-path #f] - #:skip-doc-sources? [skip-docs? #f]) + #:skip-doc-sources? [skip-docs? #f] + #:managed-compile-zo [managed-compile-zo + (make-caching-managed-compile-zo)]) (compile-directory-visitor dir info append #:verbose verbose? #:skip-path orig-skip-path - #:skip-doc-sources? skip-docs?)) + #:skip-doc-sources? skip-docs? + #:managed-compile-zo managed-compile-zo)) (define (compile-collection-zos collection #:skip-path [skip-path #f] #:skip-doc-sources? [skip-docs? #f] + #:managed-compile-zo [managed-compile-zo + (make-caching-managed-compile-zo)] . cp) (compile-directory (apply collection-path collection cp) (c-get-info (cons collection cp)) #:verbose #f #:skip-path skip-path - #:skip-doc-sources? skip-docs?)) + #:skip-doc-sources? skip-docs? + #:managed-compile-zo managed-compile-zo)) (define compile-directory-zos compile-directory) (define compile-directory-srcs get-compile-directory-srcs) diff --git a/collects/datalog/tests/test-docs-complete.rkt b/collects/datalog/tests/test-docs-complete.rkt deleted file mode 100644 index f3e76cba19..0000000000 --- a/collects/datalog/tests/test-docs-complete.rkt +++ /dev/null @@ -1,9 +0,0 @@ -#lang racket/base -(require tests/utils/docs-complete) -(check-docs (quote datalog/stx)) -(check-docs (quote datalog/runtime)) -(check-docs (quote datalog/pretty)) -(check-docs (quote datalog/parse)) -(check-docs (quote datalog)) -(check-docs (quote datalog/eval)) -(check-docs (quote datalog/ast)) diff --git a/collects/frtime/tests/test-docs-complete.rkt b/collects/frtime/tests/test-docs-complete.rkt index 079f924377..a693979c97 100644 --- a/collects/frtime/tests/test-docs-complete.rkt +++ b/collects/frtime/tests/test-docs-complete.rkt @@ -1,10 +1,7 @@ #lang racket/base (require tests/utils/docs-complete) -(check-docs (quote frtime/struct)) -(check-docs (quote frtime/reactive)) -(check-docs (quote frtime)) -(check-docs (quote frtime/gui)) -(check-docs (quote frtime/frtime)) (check-docs (quote frtime/frtime-big)) -(check-docs (quote frtime/frp-snip)) +(check-docs (quote frtime/gui/fred)) +(check-docs (quote frtime/gui)) (check-docs (quote frtime/animation)) +(check-docs (quote frtime/frlibs/math)) diff --git a/collects/html/html.scrbl b/collects/html/html.scrbl index 9bc420dceb..8d3115d236 100644 --- a/collects/html/html.scrbl +++ b/collects/html/html.scrbl @@ -1,8 +1,9 @@ #lang scribble/doc @(require scribble/manual scribble/eval - (for-label html) - (for-label xml)) + (for-label html + xml + racket/contract)) @(define xexpr @tech[#:doc '(lib "xml/xml.scrbl")]{X-expression}) @@ -64,7 +65,7 @@ Reads HTML from a port, producing an @xexpr compatible with the "
Hello world
Testing!
" "