doc update plus additional test.