fixed doc for join()
added a test for join() with hashref join specifications