Fixes a bug where the the return value of
result::insert_many::inserted_ids() could contain dangling references.

Fixes a bug where the return value of
result::insert_one::inserted_id() could contain dangling references.

This method was declared as part of the API for this class, but no
definition was ever provided.

This adds a brief reminder about `--enable-static` if desired.

Adds git download instructions pointing to release branches.  Also
reminds people to be in 'build' and remember '..'.

This reverts commit b93a23d4.

This commit rationalizes the bsoncxx iterator API for both
bsoncxx::document::view and bsoncxx::array::view:

* The non-const iterator implementation is removed; for both document::view
  and array::view, iterator is a type alias to const_iterator.
- begin(), cbegin(), end(), cend(), and find() always return
  a const_iterator.

This replaces and closes #555.

For any valid element of the wrong type, calling operator[] would
return an invalid element.  Due to a quirk, calling operator[] on
the invalid element would throw.

This commit makes operator[] not throw for the invalid element either
and updates the documentation to clarify its behavior.

The bsoncxx test binary wasn't returning test status in its exit code.
This made the binary appear to be passing even when tests were failing.

This commit replaces the buggy custom main() function with the standard
one included with the catch library, just like the mongocxx tests.

This recommends the latest stable for 3.0.x and notes
that libmongoc 1.5.0-rc3 is required for 3.1.0-beta0.

This removes the mock/ directory.  From here on, the test_util/
directory will contain test infrastructure used by mongocxx tests.

Recent builds of the server (3.4+) no longer run on RHEL 5, so the
'-latest' target for this variant is stale.  Instead, we now pin to
the '-v3.2-latest' target instead.

This better reflects the naming used by the rest of the build
infrastructure.

CXX-749 Add RHEL builder to evergreen project
CXX-873 Build against the master branch of the C driver
CXX-1022 Test driver on zSeries, Power and ARM platforms
CXX-1038 print name of each example test before running it

This commit adds a stub configuration guide page with TLS instructions.

Fixes a bug where passing the empty string to
read_concern::acknowledge_string() would incorrectly set the read
concern level to read_concern::level::k_unknown, instead of the
correct value of read_concern::level::k_server_default.

collection::count() was previously using the invalid count command
option "$hint" to issue hinted count operations.  This commit corrects
the option name to "hint".

The design of hint::to_document() is flawed in that it returns a
document with a fixed key name of "$hint", which doesn't always
represent the hint option correctly for database operations (commands
take this option with a key name of "hint", for example).

To address this issue, this commit removes knowledge of the key name
from the hint class, by adding hint::to_value() and deprecating
hint::to_document().

Previously, options::create_collection::_no_padding was always
serialized incorrectly.

The prior approach to selecting headers was to include all headers, then
exclude ones matching a regex pattern.  This was too greedy, matching parent
directories as well.

The new approach renames all private headers to .hh, which are excluded
from the list of headers to install.