From 5126a59c728c394ea38a1bd5c07551a6ec36bb19 Mon Sep 17 00:00:00 2001
From: Matthew Flatt <mflatt@racket-lang.org>
Date: Thu, 5 Jun 2008 00:21:36 +0000
Subject: [PATCH] fix single-html scribble builds by planet; fix up teachpack
 docs; add Dave to acks; add a #:use-sources in errortrace docs

svn: r10139

original commit: 413c90c0dc0f0b966e332cbdaf56266f68f86dc9
---
 collects/scribblings/scribble/renderer.scrbl | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/collects/scribblings/scribble/renderer.scrbl b/collects/scribblings/scribble/renderer.scrbl
index 5d723df4..f9817b23 100644
--- a/collects/scribblings/scribble/renderer.scrbl
+++ b/collects/scribblings/scribble/renderer.scrbl
@@ -49,7 +49,10 @@ Represents a renderer.
                  [refer-to-existing-files any/c #f]
                  [root-path (or/c path-string? false/c) #f])]{
 
-Creates a renderer whose output goes to @scheme[dest-dir].
+Creates a renderer whose output will go to @scheme[dest-dir]. For
+example, @scheme[dest-dir] could name the directory containing the
+output Latex file, the HTML file for a single-file output, or the
+output sub-directory for multi-file HTML output.
 
 If @scheme[root-path] is not @scheme[#f], it is normally the same as
 @scheme[dest-dir] or a parent of @scheme[dest-dir]. It causes
@@ -64,21 +67,30 @@ moved).}
                     [dests (listof path-string?)])
            collect-info?]{
 
-Performs the @techlink{collect pass}.}
+Performs the @techlink{collect pass}. See @method[render% render] for
+information on the @scheme[dests] argument.}
 
 @defmethod[(resolve [srcs (listof part?)]
                     [dests (listof path-string?)]
                     [ci collect-info?])
            resolve-info?]{
 
-Performs the @techlink{resolve pass}.}
+Performs the @techlink{resolve pass}. See @method[render% render] for
+information on the @scheme[dests] argument.}
 
 @defmethod[(render [srcs (listof part?)]
                    [dests (listof path-string?)]
                    [ri resolve-info?])
            void?]{
 
-Produces the final output.}
+Produces the final output.
+
+The @scheme[dests] provide names of files for Latex or single-file
+HTML output, or names of sub-directories for multi-file HTML output.
+If the @scheme[dests] are relative, they're relative to the current
+directory; normally, they should indicates a path within the
+@scheme[_dest-dir] supplied on initialization of the @scheme[render%]
+object.}
 
 @defmethod[(serialize-info [ri resolve-info?])
            any/c]{