update-vals documentation string has a typo

Question

(doc update-vals)
-------------------------
clojure.core/update-vals
([m f])
  m f => {k (f v) ...}

  Given a map m and a function f of 1-argument, returns a new map where the keys of m
  are mapped to result of applying f to the corresponding values of m.

Says "...returns a new map where the >>>keys<<< of m are mapped to...". This should be "values," not "keys." Probably a cut/paste holdover from the update-keys doc string.

Answer 1

The doc string is correct. In a map, the keys are mapped to their values. update-vals returns a new map where the keys are mapped to the new values. "Mapped" in those cases means "linked to" and not "being passed to some function".

Comments

Ah, I see. Yes. That still seems ambiguous and could be more clear, but yes, I see that it works as written as well.

Answer 2

I think the docstring is correct as written. f is applied to the values of m (as it says). The map returned is a map from the original keys to the new values.