fix for issue #27

resolves documentation conflicts for #27