This merges both documents.  README was there for historical reasons I kept it
mostly intact.  One paragraph moved to the top and there was some minor
reformatting.