From 758f1c00b3f98f673437f92065a50aab2431986e Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Mon, 30 Jun 2014 09:32:01 +0100 Subject: [PATCH] scribble & pict: add history These history notes should have been part of commits c4a58dc4a5 and 05760a12f6. original commit: dac8ba2873f3f79addb9f91b5374a42f4d7640e5 --- .../scribblings/scribble/renderer.scrbl | 18 ++++++++++++++---- .../scribblings/scribble/running.scrbl | 4 ++++ 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 index a7fe6c13..71e29c90 100644 --- 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 index 8173a4e8..df95d135 100644 --- 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