added docblock and number shortcut function