new formatting conventions
restore accidentally deleted API