final fixes to documentation

previous commits added a few functions, this one finalizes the function
for first release; submitted to GGally