whitespace
document remaining functions