major edits ch. 9

uploaded it under a new name, so we can easily check the comments in
the old doc, when needed