Backport Javadoc apiref link fixes from 4.x to master

JAVA-3525

Author: jstewart148

docs/reference/content/bson/pojos.md

@@ -40,7 +40,7 @@ Each `PropertyModel` includes:
     discriminator key and value.
 
 ClassModels are built using the [`ClassModelBuilder`]({{<apiref "org/bson/codecs/pojo/ClassModelBuilder.html">}}) which can be accessed via
- the [`ClassModel.builder(clazz)`]({{<apiref "org/bson/codecs/pojo/ClassModel.html#builder-java.lang.Class-">}}) method. The builder 
+ the [`ClassModel.builder(clazz)`]({{<apiref "org/bson/codecs/pojo/ClassModel.html#builder(java.lang.Class)">}}) method. The builder 
  initially uses reflection to create the required metadata.
 
 POJO `Codec` instances are created by the [`PojoCodecProvider`]({{<apiref "org/bson/codecs/pojo/PojoCodecProvider.html">}}) which is a
@@ -327,8 +327,8 @@ The following Conventions are available from the [`Conventions`]({{<apiref "org/
   * The [`NO_CONVENTIONS`]({{<apiref "org/bson/codecs/pojo/Conventions.html#NO_CONVENTIONS">}}) an empty list.
 
 Custom Conventions can either be set globally via the 
-[`PojoCodecProvider.Builder.conventions(conventions)`]({{<apiref "org/bson/codecs/pojo/PojoCodecProvider.Builder.html#conventions-java.util.List-">}}) 
-method, or via the [`ClassModelBuilder.conventions(conventions)`]({{<apiref "org/bson/codecs/pojo/ClassModelBuilder.html#conventions-java.util.List-">}}) 
+[`PojoCodecProvider.Builder.conventions(conventions)`]({{<apiref "org/bson/codecs/pojo/PojoCodecProvider.Builder.html#conventions(java.util.List)">}}) 
+method, or via the [`ClassModelBuilder.conventions(conventions)`]({{<apiref "org/bson/codecs/pojo/ClassModelBuilder.html#conventions(java.util.List)">}}) 
 method.
 
 {{% note class="note" %}}
@@ -408,7 +408,7 @@ If a POJO contains a field that has an abstract type or has an interface as its
 subtypes / implementations need to be registered with the `PojoCodecProvider` so that values can be encoded and decoded correctly.
 
 The easiest way to enable a discriminator is to annotate the abstract class with the `Discriminator` annotation. Alternatively, the 
-[`ClassModelBuilder.enableDiscriminator(true)`]({{<apiref "org/bson/codecs/pojo/ClassModelBuilder.html#enableDiscriminator-boolean-">}}) 
+[`ClassModelBuilder.enableDiscriminator(true)`]({{<apiref "org/bson/codecs/pojo/ClassModelBuilder.html#enableDiscriminator(boolean)">}}) 
 method can be used to enable the use of a discriminator. 
 
 The following example creates a `CodecRegistry` with discriminators enabled for a `User` interface and its concrete `FreeUser` and 

docs/reference/content/driver-async/getting-started/quick-start-pojo.md

@@ -187,7 +187,7 @@ Remember, always check for errors in any `SingleResultCallback<T>` implementatio
 For sake of brevity, this tutorial omits the error check logic in the code examples.
 {{% /note %}}
 
-To insert a Person into the collection, you can use the collection's [`insertOne()`]({{< apiref "com/mongodb/client/MongoCollection.html#insertOne-TDocument-" >}}) method.
+To insert a Person into the collection, you can use the collection's [`insertOne()`]({{< apiref "com/mongodb/client/MongoCollection.html#insertOne(TDocument)" >}}) method.
 
 ```java
 Person ada = new Person("Ada Byron", 20, new Address("St James Square", "London", "W1"));
@@ -201,7 +201,7 @@ collection.insertOne(ada, new SingleResultCallback<Void>() {
 
 ### Insert Many Persons
 
-To add multiple Person instances, you can use the collection's [`insertMany()`]({{< apiref "com/mongodb/client/MongoCollection.html#insertMany-java.util.List-" >}}) method 
+To add multiple Person instances, you can use the collection's [`insertMany()`]({{< apiref "com/mongodb/client/MongoCollection.html#insertMany(java.util.List)" >}}) method 
 which takes a list of `Person`.
 
 The following example will add multiple Person instances into the collection:
@@ -228,7 +228,7 @@ collection.insertMany(people, new SingleResultCallback<Void>() {
 
 ## Query the Collection
 
-To query the collection, you can use the collection's [`find()`]({{< apiref "com/mongodb/client/MongoCollection.html#find--">}}) method. 
+To query the collection, you can use the collection's [`find()`]({{< apiref "com/mongodb/client/MongoCollection.html#find()">}}) method. 
 
 The following example prints all the Person instances in the collection:
 ```java
@@ -249,7 +249,7 @@ SingleResultCallback<Void> callbackWhenFinished = new SingleResultCallback<Void>
 collection.find().forEach(printBlock, callbackWhenFinished);
 ```
 
-The example uses the [`forEach`]({{ <apiref "com/mongodb/client/MongoIterable.html#forEach-com.mongodb.Block-">}}) method on the ``FindIterable`` 
+The example uses the [`forEach`]({{ <apiref "com/mongodb/client/MongoIterable.html#forEach(com.mongodb.Block)">}}) method on the ``FindIterable`` 
 object to apply a block to each Person and outputs the following:
 
 ```bash
@@ -261,7 +261,7 @@ Person{id='591dbc2550852fa685b3ad1a', name='Timothy Berners-Lee', age=61, addres
 
 ## Specify a Query Filter
 
-To query for Person instance that match certain conditions, pass a filter object to the [`find()`]({{< apiref "com/mongodb/client/MongoCollection.html#find--">}}) method. 
+To query for Person instance that match certain conditions, pass a filter object to the [`find()`]({{< apiref "com/mongodb/client/MongoCollection.html#find()">}}) method. 
 To facilitate creating filter objects, Java driver provides the [`Filters`]({{< apiref "com/mongodb/client/model/Filters.html">}}) helper.
 
 {{% note class="important" %}}
@@ -272,7 +272,7 @@ By default they are the same but it is possible to change how POJO property name
 
 ### Get A Single Person That Matches a Filter
 
-For example, to find the first `Person` in the database that lives in `Wimborne` pass an [`eq`]({{<apiref  "com/mongodb/client/model/Filters.html#eq-java.lang.String-TItem-">}}) 
+For example, to find the first `Person` in the database that lives in `Wimborne` pass an [`eq`]({{<apiref  "com/mongodb/client/model/Filters.html#eq(java.lang.String,TItem)">}}) 
 filter object to specify the equality condition:
 
 ```java
@@ -301,7 +301,7 @@ collection.find(gt("age", 30)).forEach(printBlock, callbackWhenFinished);
 
 ## Update Documents
 
-To update documents in a collection, you can use the collection's [`updateOne`]({{<apiref "com/mongodb/client/MongoCollection.html#updateOne-org.bson.conversions.Bson-org.bson.conversions.Bson-">}})  and  [`updateMany`]({{<apiref "com/mongodb/async/client/MongoCollection.html#updateMany-org.bson.conversions.Bson-org.bson.conversions.Bson-">}}) methods.
+To update documents in a collection, you can use the collection's [`updateOne`]({{<apiref "com/mongodb/client/MongoCollection.html#updateOne(org.bson.conversions.Bson,org.bson.conversions.Bson)">}})  and  [`updateMany`]({{<apiref "com/mongodb/async/client/MongoCollection.html#updateMany(org.bson.conversions.Bson,org.bson.conversions.Bson)">}}) methods.
 
 Pass to the methods:
 
@@ -313,7 +313,7 @@ The update methods return an [`UpdateResult`]({{<apiref "com/mongodb/client/resu
 
 ### Update a Single Person
 
-To update at most a single `Person`, use the [`updateOne`]({{<apiref "com/mongodb/client/MongoCollection.html#updateOne-org.bson.conversions.Bson-org.bson.conversions.Bson-">}}) method.
+To update at most a single `Person`, use the [`updateOne`]({{<apiref "com/mongodb/client/MongoCollection.html#updateOne(org.bson.conversions.Bson,org.bson.conversions.Bson)">}}) method.
 
 The following example updates `Ada Byron` setting their age to `23` and name to `Ada Lovelace`:
 
@@ -329,7 +329,7 @@ collection.updateOne(eq("name", "Ada Byron"), combine(set("age", 23), set("name"
 
 ### Update Multiple Persons
 
-To update all Persons that match a filter, use the [`updateMany`]({{<apiref "com/mongodb/async/client/MongoCollection.html#updateMany-org.bson.conversions.Bson-org.bson.conversions.Bson-">}}) method.
+To update all Persons that match a filter, use the [`updateMany`]({{<apiref "com/mongodb/async/client/MongoCollection.html#updateMany(org.bson.conversions.Bson,org.bson.conversions.Bson)">}}) method.
 
 The following example sets the zip field to `null` for all documents that have a `zip` value:
 
@@ -340,7 +340,7 @@ collection.updateMany(not(eq("zip", null)), set("zip", null), printModifiedCount
 
 ### Replace a Single Person
 
-An alternative method to change an existing `Person`, would be to use the [`replaceOne`]({{<apiref "com/mongodb/client/MongoCollection.html#replaceOne-org.bson.conversions.Bson-TDocument-">}}) method.
+An alternative method to change an existing `Person`, would be to use the [`replaceOne`]({{<apiref "com/mongodb/client/MongoCollection.html#replaceOne(org.bson.conversions.Bson,TDocument)">}}) method.
 
 The following example replaces the `Ada Lovelace` back to the original document:
 
@@ -350,7 +350,7 @@ collection.replaceOne(eq("name", "Ada Lovelace"), ada, printModifiedCount);
 
 ## Delete Documents
 
-To delete documents from a collection, you can use the collection's [`deleteOne`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteOne-org.bson.conversions.Bson-">}}) and [`deleteMany`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteMany-org.bson.conversions.Bson-">}}) methods.
+To delete documents from a collection, you can use the collection's [`deleteOne`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteOne(org.bson.conversions.Bson)">}}) and [`deleteMany`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteMany(org.bson.conversions.Bson)">}}) methods.
 
 Pass to the methods a filter object to determine the document or documents to delete. To facilitate creating filter objects, Java driver provides the [`Filters`]({{< apiref "com/mongodb/client/model/Filters.html">}}) helper. To specify an empty filter (i.e. match all documents in a collection), use an empty [`Document`]({{< apiref "org/bson/Document.html" >}}) object.
 
@@ -359,7 +359,7 @@ which provides information about the operation including the number of documents
 
 ### Delete a Single Person That Matches a Filter
 
-To delete at most a single `Person` that matches a filter, use the [`deleteOne`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteOne-org.bson.conversions.Bson-">}}) method:
+To delete at most a single `Person` that matches a filter, use the [`deleteOne`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteOne(org.bson.conversions.Bson)">}}) method:
 
 The following example deletes at most one `Person` who lives in `Wimborne`:
 
@@ -376,7 +376,7 @@ collection.deleteOne(eq("address.city", "Wimborne"), printDeletedCount);
 
 ### Delete All Persons That Match a Filter
 
-To delete multiple Persons matching a filter use the [`deleteMany`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteMany-org.bson.conversions.Bson-">}}) method.
+To delete multiple Persons matching a filter use the [`deleteMany`]({{< apiref "com/mongodb/client/MongoCollection.html#deleteMany(org.bson.conversions.Bson)">}}) method.
 
 The following example deletes all Persons that live in `London`: