trans documentation and format debug