update documentation for issue #102

sections 2.22 and 2.23. Also update to Appendix B- Change log to reflect
changes.