These are great comments. The code is open source. I'm sure the owner would love a pull request that would address these concerns.
(I personally wouldn't write a book about the shell. I would be too paralyzed by the thought that at any moment, Stéphane Chazelas might crack it open.)