diff options
author | John Arthorne | 2012-05-01 13:14:33 +0000 |
---|---|---|
committer | John Arthorne | 2012-05-01 13:14:33 +0000 |
commit | 7d8429b99bb74220947c2684a96ddfed9c2d58ea (patch) | |
tree | 57a414562256e798dab7a41a946dccf970470ca4 /bundles/org.eclipse.equinox.p2.repository.tools/src | |
parent | cbf14048c0741b8fb2fabf0eb8574deabe8d5062 (diff) | |
download | rt.equinox.p2-7d8429b99bb74220947c2684a96ddfed9c2d58ea.tar.gz rt.equinox.p2-7d8429b99bb74220947c2684a96ddfed9c2d58ea.tar.xz rt.equinox.p2-7d8429b99bb74220947c2684a96ddfed9c2d58ea.zip |
Added comments to comparator classesv20120501-1314
Diffstat (limited to 'bundles/org.eclipse.equinox.p2.repository.tools/src')
3 files changed, 15 insertions, 3 deletions
diff --git a/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/JarComparator.java b/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/JarComparator.java index d79bc000d..8ebea0c89 100644 --- a/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/JarComparator.java +++ b/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/JarComparator.java @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2009, 2010 IBM Corporation and others. + * Copyright (c) 2009, 2012 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -26,6 +26,11 @@ import org.eclipse.equinox.p2.repository.artifact.IArtifactRepository; import org.eclipse.equinox.p2.repository.tools.comparator.IArtifactComparator; import org.eclipse.osgi.util.NLS; +/** + * An artifact comparator that compares two JAR files. Class files are disassembled + * and compared for equivalence, properties and manifest files are compared as such, + * all other files are compared byte-for-byte. + */ public class JarComparator implements IArtifactComparator { private static class FeatureEntryWrapper { diff --git a/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/MD5ArtifactComparator.java b/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/MD5ArtifactComparator.java index 44e34711c..86d5ddf54 100644 --- a/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/MD5ArtifactComparator.java +++ b/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/internal/repository/comparator/MD5ArtifactComparator.java @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2008, 2010 IBM Corporation and others. + * Copyright (c) 2008, 2012 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -19,6 +19,11 @@ import org.eclipse.equinox.p2.repository.artifact.IArtifactRepository; import org.eclipse.equinox.p2.repository.tools.comparator.IArtifactComparator; import org.eclipse.osgi.util.NLS; +/** + * A comparator that compares two artifacts by checking the MD5 checksum + * recorded in the artifact descriptor. This comparator doesn't actually compute MD5 + * checksums directly. + */ public class MD5ArtifactComparator implements IArtifactComparator { public static String MD5_COMPARATOR_ID = "org.eclipse.equinox.artifact.md5.comparator"; //$NON-NLS-1$ diff --git a/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/repository/tools/comparator/IArtifactComparator.java b/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/repository/tools/comparator/IArtifactComparator.java index f80091769..0eb814d33 100644 --- a/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/repository/tools/comparator/IArtifactComparator.java +++ b/bundles/org.eclipse.equinox.p2.repository.tools/src/org/eclipse/equinox/p2/repository/tools/comparator/IArtifactComparator.java @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2008, 2010 IBM Corporation and others. + * Copyright (c) 2008, 2012 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -16,6 +16,8 @@ import org.eclipse.equinox.p2.repository.artifact.IArtifactDescriptor; import org.eclipse.equinox.p2.repository.artifact.IArtifactRepository; /** + * A comparator compares two artifacts for equivalence. The exact method + * used to compare the artifacts depends on the comparator implementation used. * @since 2.0 */ public interface IArtifactComparator { |