diff --git a/pmd-core/src/main/java/net/sourceforge/pmd/properties/PropertyFactory.java b/pmd-core/src/main/java/net/sourceforge/pmd/properties/PropertyFactory.java
index 0458252d14..3de0c57225 100644
--- a/pmd-core/src/main/java/net/sourceforge/pmd/properties/PropertyFactory.java
+++ b/pmd-core/src/main/java/net/sourceforge/pmd/properties/PropertyFactory.java
@@ -46,7 +46,7 @@ import net.sourceforge.pmd.properties.constraints.PropertyConstraint;
  * <pre>
  * class MyRule {
  *   // The property descriptor may be static, it can be shared across threads.
- *   private static final {@link PropertyDescriptor}&lt;Integer> myIntProperty
+ *   private static final {@link PropertyDescriptor}&lt;Integer&gt; myIntProperty
  *     = PropertyFactory.{@linkplain #intProperty(String) intProperty}("myIntProperty")
  *                      .{@linkplain PropertyBuilder#desc(String) desc}("This is my property")
  *                      .{@linkplain PropertyBuilder#defaultValue(Object) defaultValue}(3)
@@ -235,10 +235,10 @@ public final class PropertyFactory {
      * Returns a builder for a character property. The property descriptor
      * will accept any single character string. No unescaping is performed
      * other than what the XML parser does itself. That means that Java
-     * escape sequences are not expanded: "\n", will be represented as the
+     * escape sequences are not expanded: e.g. "\n", will be represented as the
      * character sequence '\' 'n', so it's not a valid value for this type
      * of property. On the other hand, XML character references are expanded,
-     * like {@literal &amp;} ('&') or {@literal &lt;} ('<').
+     * like {@literal &amp;} ('&amp;') or {@literal &lt;} ('&lt;').
      *
      * @param name Name of the property to build
      *