Trait implementation docs list methods that can't be called

[shahn]

https://doc.rust-lang.org/std/collections/hash_map/struct.Iter.html lists "cloned" as a method for hash_map::Iter, but it doesn't actually exist because the bound on Item cannot be fulfilled. It does not make sense to list that method there, and actually confused me a lot because I thought I should be able to call it.

[steveklabnik]

I believe this has somehow been fixed, I cannot find cloned on that page anymore. Closing!

[steveklabnik]

oops, I was wrong. It's still there.

[lolbinarycat]

this would require investigating Self trait bounds, unpacking the associated item bound, and comparing that to the value of the actual associated item.

this seems like it would almost certainly not be worth it, both in terms of implementation complexity and runtime.

although i suppose it could be handy if we ever get trivial_bounds