[Converter] Update marker annotation section
@@ -1318,15 +1318,16 @@ String[] a3 = converter.convert(m3).to(MyAnnotation.class).args();</programlisti
<section>
<title>Marker annotations</title>
- <para>If the component property type is a <emphasis>marker
+ <para>If an annotation is a <emphasis>marker
annotation</emphasis>, see 9.7.2 in <xref
linkend="util.converter-jls.ref"/>, then the property name is
- derived from the name of the component property type, as is
+ derived from the name of the annotation, as is
described above for single-element annotations, and the value of the
property is <code>Boolean.TRUE</code>.</para>
- <para>Marker annotations can only be used as a source of a
- conversion. Specifying a marker annotation as the target of a
+ <para>When converting to a marker annotation the converter checks that the source
+ has key and value that are consistent with the marker annotation. If they are not,
+ for example if the value is not present or does not convert to <code>Boolean.TRUE</code>, then a
conversion will result in a Conversion Exception.</para>
</section>
