Python Sphinx Inline Docs

gistfile1.py

def func(arg1, arg2):
    """
    Summary.
    
    Long explanation...
    
    :param arg1: Descr for arg1
    :type arg1: arg1 type
    
    :param arg2: Descr for arg2
    :type arg2: arg2 type
    
    :raises IndexError: Descr of the exception
    :returns: Descr of the return value
    :rtype: return value type
    
    :var var1: Describing an internal variable
    """
    
    #: :type: some type
    var1 = None