update to non-windows formats, and add a little doc