updated docblock for join methods, ref #90