def annotate(*,
             start_msg: Optional[str] = None,
             end_msg: Optional[str] = None,
             start_no_nl: bool = False) -> types.AnyFunction:
    """A decorator meant for decorating functions that are decorated with the
    `animate` decorator. It prints a message to stdout before and/or after the
    function has finished.

    .. DANGER::

        This decorator can also be used standalone, but you should NOT decorate a
        function that is decorated with `annotate` with `animate`. That is to say,
        the decorator order must be like this:

        .. code-block:: python

            @annotate
            @animate
            def some_function()
                pass
    """
    return core.Annotate(start_msg=start_msg, end_msg=end_msg, start_no_nl=start_no_nl)