Fix #377

Author: cowtowncoder

parameter-names/README.md

@@ -1,5 +1,4 @@
-Jackson module
-that adds support for accessing parameter names; a feature added in JDK 8.
+Jackson module that adds support for accessing parameter names; a feature added in JDK 8.
 
 ## Usage
 
@@ -12,6 +11,11 @@ For maven dependency definition, click on the second badge in the previous, Stat
 Like all standard Jackson modules (libraries that implement Module interface), registration is done as follows:
 
 ```java
+ObjectMapper mapper = JsonMapper.builder()
+    .addModule(new ParameterNamesModule())
+    .build();
+
+// Or, older (pre-2.10):
 ObjectMapper mapper = new ObjectMapper();
 mapper.registerModule(new ParameterNamesModule());
 ```
@@ -26,9 +30,9 @@ To override this behavior use the `ParameterNamesModule` constructor with `JsonC
 For example, to use same behavior as for constructors with multiple parameters:
 ```java
 
-ObjectMapper objectMapper = new ObjectMapper();
-objectMapper.registerModule(new ParameterNamesModule(JsonCreator.Mode.PROPERTIES));
-
+ObjectMapper mapper = JsonMapper.builder()
+    .addModule(new ParameterNamesModule(JsonCreator.Mode.PROPERTIES))
+    .build();
 ```
 
 ### Usage example
@@ -76,14 +80,15 @@ class Person {
 
 Preconditions:
 
-  - class Person must be compiled with Java 8 compliant compiler with option to store formal parameter names turned on (`-parameters` option). For more information about Java 8 API for accessing parameter names at runtime see [this][2]
-  - if there are multiple visible constructors and there is no default constructor, `@JsonCreator` is required to select constructor for deserialization
-  - if used with `jackson-databind` lower than  `2.6.0`, `@JsonCreator` is required. In practice, `@JsonCreator` is also often required with `2.6.0+` due to issues with constructor discovery that will be resolved in `2.7`.
-  - if class Person has a single argument constructor, its argument needs to be annotated with `@JsonProperty("propertyName")`. This is to preserve legacy behavior, see [FasterXML/jackson-databind/#1498][3]
+- class Person must be compiled with Java 8 compliant compiler with option to store formal parameter names turned on (`-parameters` option). For more information about Java 8 API for accessing parameter names at runtime see [this][2]
+- if there are multiple visible constructors and there is no default constructor, `@JsonCreator` is required to select constructor for deserialization
+- if used with `jackson-databind` lower than  `2.6.0`, `@JsonCreator` is required. In practice, `@JsonCreator` is also often required with `2.6.0+` due to issues with constructor discovery that will be resolved in `2.7`.
+- if class Person has a single-argument constructor, its argument needs to be annotated with `@JsonProperty("propertyName")`. This is to preserve legacy behavior, see [FasterXML/jackson-databind/#1498][3]
+
 ## More
 
 See [Wiki](../../../wiki) for more information (javadocs, downloads).
 
-[1]: http://jackson.codehaus.org/1.1.2/javadoc/org/codehaus/jackson/annotate/JsonProperty.html
+[1]: https://javadoc.io/static/com.fasterxml.jackson.core/jackson-annotations/2.20/com/fasterxml/jackson/annotation/JsonProperty.html
 [2]: http://docs.oracle.com/javase/tutorial/reflect/member/methodparameterreflection.html
 [3]: https://github.com/FasterXML/jackson-databind/issues/1498