Use Automake's test driver

Instead of the custom check-local target we had before, use Automake's
test driver.
Make changes so that 'make distcheck' passes

- In test-plist.c, make sure to load all test data from srcdir
- Put osxcart.vapi in DISTCLEANFILES
- Add index of deprecated API to documentation
- Generally fix srcdir and builddir as appropriate