functions are skeletons with boilerplate

[antoniojbt]

Functions need completing:

• write documentation
• write actual function: code was copied across but not in shape
• add tests for each