documentation changes; workaround issue with autodoc & decorators with explicit use of py:function in ReST documents