more documentation, no warnings