update README/MANPAGE for current shell status

Also adjust the things-to-be-done list.