more initial fixes, documentation, warnings