But that doesn't answer the question :p

The JavaDocs mention this "leash" entity, but the method signature mentions an "Entity".

If this method can ONLY accept leash entities, then the signature should reflect that. If it can accept any entity then the JD should reflect that.

If it stays the way it is someone will try to link a pig to a snowball (now that I say that, I want to try it...)