introduced  and docstrings for block functions