impoved usage doc