Functions

def function(arg):
    '''this is a docstring'''

    # do something
    return

# example
def power(base, x):
    '''multiply base with itself x times'''

    return base ** x

print(power(2, 3))                  # 8
print(power.__doc__)                # multiply base with itself x times

# default arguments
def power(base, x = 3):
    return base ** x

print(power(2))
# 8

# multiple return values
def power(base, x):
    result = base ** x
    return result, base

result, base = power(2, 3)
print(result, base)
# 8 2