Update documentation to match changes to BP file finding

Recent changes support specifying a BP file from a JSON file relative to
the location of the JSON file. Although the old method of specifying
paths is still supported, this new method is preferrable and should be
documented.

The documentation for the schema and the C++ reader interface are
updated to document this new method.