added intercalate JavaDoc
added intercalate tests