doc clarifications on dc-path

svn: r11919

collects/scribblings/gui/dc-intf.scrbl

@@ -199,9 +199,10 @@ See also @method[dc<%> set-smoothing] for information on the
            void?]{
 
 Draws the sub-paths of the given @scheme[dc-path%] object, adding
- @scheme[xoffset] and @scheme[yoffset] to each point. The current pen
+ @scheme[xoffset] and @scheme[yoffset] to each point. (See
- is used for drawing the path as a line, and the current brush is used
+ @scheme[dc-path%] for general information on paths and sub-paths.)
- for filling the area bounded by the path.
+ The current pen is used for drawing the path as a line, and the
+ current brush is used for filling the area bounded by the path.
 
 If both the pen and brush are non-transparent, the path is filled with
  the brush before the outline is drawn with the pen. The filling and
@@ -350,11 +351,13 @@ See also @method[dc<%> set-smoothing] for information on the
                         [y3 real?])
            void?]{
 
-Draws a spline from (@scheme[x1], @scheme[y1]) to (@scheme[x3], @scheme[y3])
+@index['("drawing curves")]{Draws} a spline from (@scheme[x1],
- using (@scheme[x2], @scheme[y2]) as the control point.
+ @scheme[y1]) to (@scheme[x3], @scheme[y3]) using (@scheme[x2],
+ @scheme[y2]) as the control point.
 
 See also @method[dc<%> set-smoothing] for information on the
-@scheme['aligned] smoothing mode.
+ @scheme['aligned] smoothing mode. See also @scheme[dc-path%] and
+ @method[dc<%> draw-path] for drawing more complex curves.
 
 @|DrawSizeNote|
 
@@ -918,7 +921,7 @@ Starts a page, relevant only when drawing to a printer or PostScript
  device (including to a PostScript file).
 
 For printer or PostScript output, an exception is raised if
- @scheme[start-doc] is called when a page is already started, or when
+ @scheme[start-page] is called when a page is already started, or when
  @method[dc<%> start-doc] has not been called, or when @method[dc<%>
  end-doc] has been called already. In addition, in the case of
  PostScript output, Encapsulated PostScript (EPS) cannot contain

collects/scribblings/gui/dc-path-class.scrbl

@@ -14,7 +14,8 @@ A path consists of zero or more @deftech{closed sub-paths}, and
  possibly one @deftech{open sub-path}. Some @scheme[dc-path%] methods
  extend the open sub-path, some @scheme[dc-path%] methods close the
  open sub-path, and some @scheme[dc-path%] methods add closed
- sub-paths.
+ sub-paths. This approach to drawing formulation is inherited from
+ PostScript @cite["Adobe99"].
 
 When a path is drawn as a line, a closed sub-path is drawn as a closed
  figure, analogous to a polygon. An open sub-path is drawn with

collects/scribblings/gui/gui.scrbl

@@ -31,6 +31,19 @@ provides; this library cannot run in MzScheme.}
 @include-section["config.scrbl"]
 @include-section["dynamic.scrbl"]
 
+
+@;------------------------------------------------------------------------
+
+@(bibliography
+
+  (bib-entry #:key "Adobe99"
+             #:author "Adobe Systems Incorporated"
+             #:title @italic{PostScript Language Reference, third edition}
+             #:url "http://partners.adobe.com/public/developer/en/ps/PLRM.pdf"
+             #:date "1999")
+
+  )
+
 @;------------------------------------------------------------------------
 
 @index-section[]