more doc tweaking and warning removal