Improve Variant documentation.

Change-Id: Ic25729c8bf2e71cdfcf54e3a2794664b400723bd
diff --git a/src/main/java/eu/mulk/jgvariant/core/Decoder.java b/src/main/java/eu/mulk/jgvariant/core/Decoder.java
index 389ae85..d0c0323 100644
--- a/src/main/java/eu/mulk/jgvariant/core/Decoder.java
+++ b/src/main/java/eu/mulk/jgvariant/core/Decoder.java
@@ -141,9 +141,9 @@
   }
 
   /**
-   * Creates a {@link Decoder} for the {@code Variant} type.
+   * Creates a {@link Decoder} for the {@link Variant} type.
    *
-   * <p>The returned {@link Object} can be of one of the following types:
+   * <p>The contained {@link Object} can be of one of the following types:
    *
    * <ul>
    *   <li>{@link Boolean}
@@ -155,6 +155,7 @@
    *   <li>{@link Optional} (a GVariant {@code Maybe} type)
    *   <li>{@link List} (a GVariant array)
    *   <li>{@link Object[]} (a GVariant structure)
+   *   <li>{@link Variant} (a nested variant)
    * </ul>
    *
    * @return a new {@link Decoder}.
@@ -164,7 +165,7 @@
   }
 
   /**
-   * Creates a {@link Decoder} for the {@code Boolean} type.
+   * Creates a {@link Decoder} for the {@code boolean} type.
    *
    * @return a new {@link Decoder}.
    */