2 things: documentation + changes to STDIN

Unfortunately two things here.  One is just documentation.  The other are
changes to STDIN, I think trying to allow it to read from STDIN iteratively,
but I don't really remember...