From d39cbf9c57a8fb55f2939d5cc84dca9cbacf8be2 Mon Sep 17 00:00:00 2001
From: Matthew Flatt <mflatt@racket-lang.org>
Date: Thu, 8 Oct 2009 12:25:24 +0000
Subject: [PATCH] add some cross-references to sequence defns

svn: r16280
---
 collects/scribblings/reference/sequences.scrbl | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/collects/scribblings/reference/sequences.scrbl b/collects/scribblings/reference/sequences.scrbl
index 415a4d22f8..befc9269cc 100644
--- a/collects/scribblings/reference/sequences.scrbl
+++ b/collects/scribblings/reference/sequences.scrbl
@@ -17,6 +17,9 @@
        (the-eval '(require scheme/generator))
        the-eval)))
 
+@(define (info-on-seq where what)
+   @margin-note{See @secref[where] for information on using @|what| as sequences.})
+
 @title[#:tag "sequences"]{Sequences}
 
 @guideintro["sequences"]{sequences}
@@ -85,6 +88,7 @@ element. @speed[in-naturals "integer"]}
 
 @defproc[(in-list [lst list?]) sequence?]{
 Returns a sequence equivalent to @scheme[lst].
+@info-on-seq["pairs" "lists"]
 @speed[in-list "list"]}
 
 @defproc[(in-vector [vec vector?]
@@ -96,6 +100,8 @@ Returns a sequence equivalent to @scheme[lst].
 Returns a sequence equivalent to @scheme[vec] when no optional
 arguments are supplied.
 
+@info-on-seq["vectors" "vectors"]
+
 The optional arguments @scheme[start], @scheme[stop], and
 @scheme[step] are analogous to @scheme[in-range], except that a
 @scheme[#f] value for @scheme[stop] is equivalent to
@@ -124,6 +130,8 @@ demanded from the sequence.
 Returns a sequence equivalent to @scheme[str] when no optional
 arguments are supplied.
 
+@info-on-seq["strings" "strings"]
+
 The optional arguments @scheme[start], @scheme[stop], and
 @scheme[step] are as in @scheme[in-vector].
 
@@ -137,6 +145,8 @@ The optional arguments @scheme[start], @scheme[stop], and
 Returns a sequence equivalent to @scheme[bstr] when no optional
 arguments are supplied.
 
+@info-on-seq["bytestrings" "byte strings"]
+
 The optional arguments @scheme[start], @scheme[stop], and
 @scheme[step] are as in @scheme[in-vector].
 
@@ -159,7 +169,9 @@ mode is @scheme['any], whereas the default mode of @scheme[read-line]
 is @scheme['linefeed].}
 
 @defproc[(in-hash [hash hash?]) sequence?]{
-Returns a sequence equivalent to @scheme[hash].}
+Returns a sequence equivalent to @scheme[hash].
+
+@info-on-seq["hashtables" "hash tables"]}
 
 @defproc[(in-hash-keys [hash hash?]) sequence?]{
 Returns a sequence whose elements are the keys of @scheme[hash].}