@@ -136,10 +136,20 @@
 
 The @code{url} tag for a given identifier may be placed anywhere in the document, even before it is
 referenced. If you create a @code{link} for an identifier that has no corresponding @code{url},
 a @code{"Missing reference: [link-id]"} message will be substituted for the URL. Conversely, 
 creating a @code{url} that is never referenced will produce no output and no warnings or errors.
+
+@deftogether[(@defproc[(figure     [image-file string?] [caption xexpr?] ...) txexpr?]
+              @defproc[(figure-@2x [image-file string?] [caption xexpr?] ...) txexpr?])]
+
+Insert a block-level image. The @racket[_image-file] should be supplied as a filename only, with no
+folder names. It is assumed that the image is located inside an @racket[images-folder] within the
+same folder as the source document.
+
+For web output, using @racket[figure-@2x] will produce an image hard-coded to display at half its
+actual size, or the width of the text block, whichever is smaller.
 
 @deftogether[(@defproc[(fn    [fn-id stringish?]) txexpr?]
               @defproc[(fndef [fn-id stringish?] [elements xexpr?] ...) txexpr?])]
 
 As with hyperlinks, footnotes are specified reference-style. In the output, footnotes will be