Document that we assume exact digest matching in c/common/pkg/manifests

This is all fine and internally consistent, but eventually that
assumption will probably require changes in the Podman caller of
c/common/libimage.ManifestList.RemoveInstance.

Should not change behavior.

Signed-off-by: Miloslav Trmač <[email protected]>

Author: mtrmac

common/pkg/manifests/manifests.go

@@ -18,6 +18,8 @@ import (
 
 // List is a generic interface for manipulating a manifest list or an image
 // index.
+//
+// Note: the instanceDigest values used for lookups/removals must exactly match the digests in the manifest list, in particular use the algorithm used there.
 type List interface {
 	AddInstance(manifestDigest digest.Digest, manifestSize int64, manifestType, os, architecture, osVersion string, osFeatures []string, variant string, features []string, annotations []string) error
 	Remove(instanceDigest digest.Digest) error