From 0f9cac182de75774a1dc106bbb959615e1cd7527 Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Sat, 10 Apr 2010 14:13:41 +0000 Subject: [PATCH] improve docs to calrify that mutable pairs are not pairs svn: r18779 --- collects/scribblings/reference/mpairs.scrbl | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/collects/scribblings/reference/mpairs.scrbl b/collects/scribblings/reference/mpairs.scrbl index 0edb8084e4..cea0235850 100644 --- a/collects/scribblings/reference/mpairs.scrbl +++ b/collects/scribblings/reference/mpairs.scrbl @@ -13,6 +13,11 @@ Scheme pairs). A @deftech{mutable list} is analogous to a list created with pairs, but instead created with mutable pairs. +A @tech{mutable pair} is not a @tech{pair}, and a @tech{mutable list} +is not a @tech{list}; they are completely separate datatypes. Pairs, +lists, hash tables, and other data structures are practically always +better choices than mutable pairs and mutable lists. + @; ---------------------------------------- @section{Mutable Pair Constructors and Selectors}