DFRS-4 - update docstring for create-reader and create-writer

Author: puredanger

src/main/clojure/clojure/data/fressian.clj

@@ -192,16 +192,17 @@
 
 (defn ^Writer create-writer
   "Create a fressian writer targeting out. Handlers must be
-   a nested map of type => tag => WriteHandler, see
+   a nested map of type => tag => WriteHandler wrapped with
+   associative-lookup and inheritance-lookup. See
    clojure-write-handlers for an example."
   [^OutputStream out & {:keys [handlers]}]
   (FressianWriter. out (or handlers (-> clojure-write-handlers associative-lookup inheritance-lookup))))
 
 (defn ^Reader create-reader
   "Create a fressian reader targeting in, which must be compatible
-   with clojure.java.io/input-stream.  Handlers can be an ILookup
-   or a map of tag => ReadHandler, see clojure-read-handlers for
-   an example."
+   with clojure.java.io/input-stream.  Handlers must be a map of
+   tag => ReadHandler wrapped in associative-lookup. See
+   clojure-read-handlers for an example."
   [^InputStream in & {:keys [handlers checksum?]}]
   (FressianReader. in
                    (or handlers (associative-lookup clojure-read-handlers))