documentation, formatting, removed build warnings