Re: [cp-patches] [Patch] jar attributes

[Mark Wielaard]

Hi,

On Fri, 2005-01-28 at 11:13 +0100, Michael Koch wrote:
> I commited the attached patch to remove some stuff in our API that is
> not in SUNs public javadocs. And its not needed inside Classpath too.
>
> 2005-01-28  Michael Koch  <address@hidden>
> 
>       * java/util/jar/Attributes.java
>       (CREATED_BY, JAVA_BEAN, MAGIC): Removed.

These were described in the netscape jar specification (which was more
clear about the jar format then any other description I could find at
the time I was implementing this). I would like to keep the description
of these attributes to help people better understand the Manifest
attributes. So I am committing this documentation patch:

2005-01-28  Mark Wielaard  <address@hidden>

        * java/util/jar/Attributes.java (Attributes.Name): Add documentation
        to describe attributes without a constant field value in this class.

Cheers,

Mark


Index: java/util/jar/Attributes.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/util/jar/Attributes.java,v
retrieving revision 1.10
diff -u -r1.10 Attributes.java
--- java/util/jar/Attributes.java       28 Jan 2005 10:09:42 -0000      1.10
+++ java/util/jar/Attributes.java       28 Jan 2005 14:42:03 -0000
@@ -1,5 +1,5 @@
 /* Attributes.java -- Represents attribute name/value pairs from a Manifest
-   Copyright (C) 2000, 2002 Free Software Foundation, Inc.
+   Copyright (C) 2000, 2002, 2005 Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -98,6 +98,18 @@
    * converted to lowercase. But you can get the original case sensitive
    * string with the <code>toString()</code> method.</p>
    *
+   * <p>Most important attributes have a constant defined in this
+   * class. Some other attributes used in Manifest files are:
+   * <ul>
+   * <li> "Created-By" - General main attribute, tool and version
+   * that created this Manifest file.</li>
+   * <li> "Java-Bean" - Bean objects attribute, whether the entry is a Bean.
+   * Value is either "true" or "false".</li>
+   * <li> "Magic" - Signing attribute, application specific signing attribute.
+   * Must be understood by the manifest parser when present to validate the
+   * jar (entry).</li>
+   * </ul>
+   *
    * @since 1.2
    * @author Mark Wielaard (address@hidden)
    */

signature.asc
Description: This is a digitally signed message part