Add sensible/useful @error/@warn messages

[esr360]

There are currently no custom @error or @warn messages to assist the user. This story is to go through all code and add basic messages where required - no need to be too defensive.