Here's a patch updating "manpage.txt" in many respects. I wasn't able to address all of the open issues at the end because I either don't understand exactly what's being asked or I need an exhibit of failing input, but I think I clarified some of them.
thanks a lot, applied.
I moved the open issue list at the end,
This was intended for discussion when I started the writer ... no one ever read up to now.
thanks a lot ... applied