The existing doc had a number of info gaps and was a little hard to use.  This patch provides several quick-reference tables as well as examples.