#8 Document new implemenation details

[Jason E. Stewart]

There have been some significant changes to the inner
workings of the code not listed in APP. These changes
should be documented so that the maintainers can
understand what is going on.