CDRIVER-3985 Remove Oppressive Terminology From Code

[alcaeus]

CDRIVER-3985

This PR deprecates and removes oppressive terminology from code. The spec test changes will be synced one more time once mongodb/specifications#990 is merged.

The last two commits commit are the changes from #793 and #792 to keep the build somewhat happy, so I would recommend looking at the changes commit by commit.

[benjirewis]

Looking good!

[benjirewis]

LGTM!

[kevinAlbs]

Looking great!

I ran the grep command that James included in the comment of CDRIVER-3887, I think there are a handful of docs that need updating (the other "not master" changes in code I think will be part of CDRIVER-3997):

$ find . -iname "*.rst" | xargs ggrep -PriI '(docs\.mongodb\.com\/master|(?<!/)master(?!.?key)|slave|whitelist|blacklist)' 
./libmongoc/tests/json/retryable_reads/README.rst:waiting time after a "not master" error:
./libmongoc/doc/installing.rst:Clone the repository and prepare the build on the current master branch or a particular release tag:
./libmongoc/doc/mongoc_server_description_t.rst:    mongoc_server_description_ismaster
./libmongoc/doc/mongoc_collection_update_many.rst:  | `MongoDB update command documentation <https://docs.mongodb.com/master/reference/command/update/>`_ for more information on the update options.
./libmongoc/doc/mongoc_collection_update_one.rst:  | `MongoDB update command documentation <https://docs.mongodb.com/master/reference/command/update/>`_ for more information on the update options.
./libmongoc/doc/mongoc_server_description_hello_response.rst:`"hello" <https://docs.mongodb.org/manual/reference/command/isMaster/>`_
./libmongoc/doc/mongoc_read_concern_t.rst:See `Read Concern Levels <https://docs.mongodb.com/master/reference/read-concern/#read-concern-levels>`_ in the MongoDB manual for more information about the individual read concern levels.
./libmongoc/doc/mongoc_client_set_appname.rst:Sets the application name for this client. This string, along with other internal driver details, is sent to the server as part of the initial connection handshake (`"hello" <https://docs.mongodb.org/manual/reference/command/isMaster/>`_).
./libmongoc/doc/mongoc_collection_replace_one.rst:  | `MongoDB update command documentation <https://docs.mongodb.com/master/reference/command/update/>`_ for more information on the update options.

I think docs links can be updated:

• master => manual.
• https://docs.mongodb.com/manual/reference/command/isMaster/ => https://docs.mongodb.com/manual/reference/command/hello/

[kevinAlbs]

Good thinking. I originally thought you removed MONGOC_QUERY_SLAVE_OK entirely. But leaving it out of documentation seems like a good idea.

I filed CDRIVER-4006 to track removing public symbols in the next major release.

[kevinAlbs]

This may have been an unintentional change from find/replace. Though it's better to document deprecated symbols, existing users of mongoc_server_description_ismaster will get a warning during upgrade about the because of BSON_GNUC_DEPRECATED_FOR (mongoc_server_description_hello_response).

[alcaeus]

Yes, this was an unintended change, good catch! I've reverted this to the legacy naming; documentation for the deprecated function should stay in place until the function itself is removed.

[alcaeus]

Yes, more changes are incoming for CDRIVER-3997, which should also take care of the last tests. I've removed the other instances shown in your comment.

[kevinAlbs]

LGTM mod one minor comment:

• README.rst has "- Examples: master branch, 1.9.5 tag". I don't think the branch helps, so I think this can be just "- Examples: 1.9.5 tag"