Merge pull request #620 from ndw/iss-1112

Describe the comment attribute on c:entry elements

steps/src/main/xml/steps/archive.xml

@@ -208,6 +208,15 @@
         </listitem>
         </itemizedlist>
       </listitem>
+
+      <listitem>
+        <para>The <code>comment</code> attribute specifies a comment associated with the
+        entry. If the archive format does not support per-entry comments, the value
+        of this attribute is ignored. <impl>If the format imposes constraints on the archive
+        comment (character set or length, for example), how the processor coerces the attribute value
+        to satisfy those constraints is <glossterm>implementation-dependent</glossterm>.</impl></para>
+      </listitem>
+
       <listitem>
         <para>The <code>method</code> attribute specifies how the entry should be compressed.
             <impl>The default compression method is <glossterm>implementation-defined</glossterm>.