Updated docs to reflect new debian packaging arrangements

These are a first cut at updated documentation.

There will be some minor changes after the new debian release, but it covers the current usage.