I am going to post my draft man page to debian-devel for commentary. Once it has been given a look-over, I'll post a revised version here. Or let me know if I should send it directly to a particular person.