[doc] Documentation fixes in join generic function and method pointed by @cgay
Merge pull request #397 from abeaumont/documentation-join

[doc] Documentation fixes in join generic function and method pointed by @cgay