Describe the comment attribute on c:entry elements

xproc · Aug 31, 2024 · 77d9786 · 77d9786
1 parent ddb8cf3
commit 77d9786
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/steps/src/main/xml/steps/archive.xml b/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>.