Dostęp do historii `ref` w Clojure

Dokumentacja ref pokazuje opcję: max-historii i stwierdza, że „sędziowie gromadzić historię dynamicznie, ile potrzeba do czynienia z czytanych żądań.” Widzę, że na REPL jest historia, ale nie widzę, jak znaleźć poprzednie wartości referencji:

user=> (def the-world (ref "hello" :min-history 10))
#'user/the-world
user=> (do
          (dosync (ref-set the-world "better"))
          @the-world)
"better"
user=> (let [exclamator (fn [x] (str x "!"))]
          (dosync
           (alter the-world exclamator)
           (alter the-world exclamator)
           (alter the-world exclamator))
          @the-world)
"better!!!"
user=> (ref-history-count the-world)
2

Prawdopodobnie świat ma wartości „cześć”, „lepiej” i „lepiej !!!”. Jak uzyskać dostęp do tej historii?

Jeśli nie można uzyskać dostępu do tej historii, to czy istnieje typ danych, który przechowuje historię swoich wartości, które można później zapytać? A może właśnie dlatego stworzono bazę danych?

Wierzę, że: min-history i: max-history odnoszą się tylko do historii ref podczas transakcji.

Oto jednak sposób na zrobienie tego za pomocą atomu i obserwatora:

user> (def the-world (ref "hello"))
#'user/the-world
user> (def history-of-the-world (atom [@the-world]))
#'user/history-of-the-world
user> history-of-the-world
#<Atom@6ef167bb: ["hello"]>
user> (add-watch the-world :historian
                 (fn [key world-ref old-state new-state]
                   (if (not= old-state new-state)
                     (swap! history-of-the-world conj new-state))))
#<Ref@47a2101a: "hello">
user> (do
        (dosync (ref-set the-world "better"))
        @the-world)
"better"      
user> (let [exclamator (fn [x] (str x  "!"))]
        (dosync
          (alter the-world exclamator)
          (alter the-world exclamator)
          (alter the-world exclamator))
        @the-world)
"better!!!"
user> @history-of-the-world
["hello" "better" "better!!!"]