From 074b611215653705571ab5179aa8c4f4d2350b2e Mon Sep 17 00:00:00 2001
From: Matthew Flatt <mflatt@racket-lang.org>
Date: Tue, 12 Feb 2008 15:16:03 +0000
Subject: [PATCH] more browser doc repairs

svn: r8634
---
 collects/browser/browser.scrbl             |  2 +-
 collects/scribblings/scribble/manual.scrbl | 19 ++++++++++++++-----
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/collects/browser/browser.scrbl b/collects/browser/browser.scrbl
index 3d2554cbe1..921e3b7518 100644
--- a/collects/browser/browser.scrbl
+++ b/collects/browser/browser.scrbl
@@ -379,7 +379,7 @@ The @(litchar "MZSCHEME") forms are disabled unless the web page is a
         This method is called by the hypertext canvas to notify the
         panel that the hypertext page changed. The @scheme[page] is @scheme[#f]
         if @scheme[new-page] is the first page for the canvas. See also
-        @method[hyper-panel-mixin page->editor].
+        @scheme[page->editor].
         }
 
         @defmethod[(filter-notes [notes (listof string?)])
diff --git a/collects/scribblings/scribble/manual.scrbl b/collects/scribblings/scribble/manual.scrbl
index b6306d1440..5c2c541a48 100644
--- a/collects/scribblings/scribble/manual.scrbl
+++ b/collects/scribblings/scribble/manual.scrbl
@@ -513,12 +513,15 @@ at once, aligned around the @litchar{=} and @litchar{|}.}
 @; ------------------------------------------------------------------------
 @section[#:tag "doc-classes"]{Documenting Classes and Interfaces}
 
-@defform[(defclass id super-id (intf-id ...) pre-flow ...)]{
+@defform/subs[(defclass id super (intf-id ...) pre-flow ...)
+              ([super super-id
+                      (mixin-id super)])]{
 
 Creates documentation for a class @scheme[id] that is a subclass of
-@scheme[super-id] and implements each interface @scheme[intf-id]. Each
-@scheme[super-id] (except @scheme[object%]) and @scheme[intf-id] must
-be documented somewhere via @scheme[defclass] or @scheme[definterface].
+@scheme[super] and implements each interface @scheme[intf-id]. Each
+identifier in @scheme[super] (except @scheme[object%]) and
+@scheme[intf-id] must be documented somewhere via @scheme[defclass] or
+@scheme[definterface].
 
 The decoding of the @scheme[pre-flow] sequence should start with
 general documentation about the class, followed by constructor
@@ -527,7 +530,7 @@ definitions (see @scheme[defmethod]). In rendered form, the
 constructor and method specification are indented to visually group
 them under the class definition.}
 
-@defform[(defclass/title id super-id (intf-id ...) pre-flow ...)]{
+@defform[(defclass/title id super (intf-id ...) pre-flow ...)]{
 
 Like @scheme[defclass], also includes a @scheme[title] declaration
 with the style @scheme['hidden]. In addition, the constructor and
@@ -580,6 +583,12 @@ of by-name arguments (for use with @scheme[new]).}
 Like @scheme[defconstructor/make], but with multiple constructor
 patterns analogous @scheme[defproc*].}
 
+@defform[(defconstructor/super-init [(arg-spec ...) ...] pre-flow ...)]{
+
+Like @scheme[defconstructor/super-init], but the constructor is
+annotated to indicate that additional initialization arguments are
+accepted and propagated to the sueprclass.}
+
 @defform[(defmethod (id arg-spec ...)
                     result-contract-expr-datum
                     pre-flow ...)]{