join functions added to documentation