commit 758f1c00b3f98f673437f92065a50aab2431986e
parent 36df8c0c56eea8ef87233b57bace673c5f5ac7c2
Author: Matthew Flatt <mflatt@racket-lang.org>
Date: Mon, 30 Jun 2014 09:32:01 +0100
scribble & pict: add history
These history notes should have been part of commits c4a58dc4a5 and
05760a12f6.
original commit: dac8ba2873f3f79addb9f91b5374a42f4d7640e5
Diffstat:
2 files changed, 18 insertions(+), 4 deletions(-)
diff --git a/pkgs/scribble-pkgs/scribble-doc/scribblings/scribble/renderer.scrbl b/pkgs/scribble-pkgs/scribble-doc/scribblings/scribble/renderer.scrbl
@@ -104,7 +104,9 @@ written to the current output port.
If @racket[warn-undefined?] is a true value, then references to
missing cross-reference targets trigger a warning message on the
-current error port.}
+current error port.
+
+@history[#:changed "1.4" @elem{Added the @racket[#:image-preferences] argument.}]}
@section{Base Renderer}
@@ -261,7 +263,8 @@ Represents a renderer.
[prefix-file (or/c path-string? #f) #f]
[style-file (or/c path-string? #f) #f]
[style-extra-files (listof path-string?) null]
- [extra-files (listof path-string?) null])]{
+ [extra-files (listof path-string?) null]
+ [image-preferences (listof (or/c 'ps 'pdf 'png 'svg 'gif)) null])]{
Creates a renderer whose output will go to @racket[dest-dir]. For
example, @racket[dest-dir] could name the directory containing the
@@ -287,8 +290,15 @@ styles in a formal-specific way; see @secref["config-style"] for more
information.
The @racket[extra-files] argument names files to be copied to the
-output location, such as image files or extra configuration files.}
-}
+output location, such as image files or extra configuration files.
+
+The @racket[image-preferences] argument specified preferred formats
+for image files and conversion, where formats listed earlier in the
+list are more preferred. The renderer may not support all of the
+formats listed in @racket[image-preferences].
+
+@history[#:changed "1.4" @elem{Added the @racket[image-preferences]
+ initialization argument.}]}}
@; ----------------------------------------
diff --git a/pkgs/scribble-pkgs/scribble-doc/scribblings/scribble/running.scrbl b/pkgs/scribble-pkgs/scribble-doc/scribblings/scribble/running.scrbl
@@ -72,6 +72,8 @@ information in one document is visible to the other documents. See
@secref["xref-flags"] for information on references that cross
documents that are built separately.
+@history[#:changed "1.4" @elem{Added @DFlag{dvipdf}.}]
+
@section{Extra and Format-Specific Files}
Use the @DFlag{style} flag to specify a format-specific file to adjust
@@ -188,6 +190,8 @@ ps}. To generate HTML pages with images converted to SVG format
instead of PNG format, combine @DFlag{html} with
@exec{@DPFlag{convert} svg}.
+@history[#:changed "1.4" @elem{Added @DPFlag{convert} support.}]
+
@section{Passing Command-Line Arguments to Documents}
When @exec{scribble} loads and renders a document module, by default
