From 420cd29beb42ab9831fbecadd823d7eca8ab9d2e Mon Sep 17 00:00:00 2001
From: Lokesh Mandvekar <lsm5@redhat.com>
Date: Wed, 3 Dec 2025 14:15:40 -0500
Subject: [PATCH] docs: manpage update for `skopeo inspect --manifest-digest`

Signed-off-by: Lokesh Mandvekar <lsm5@redhat.com>
---
 docs/skopeo-inspect.1.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/skopeo-inspect.1.md b/docs/skopeo-inspect.1.md
index c3034506..622cd601 100644
--- a/docs/skopeo-inspect.1.md
+++ b/docs/skopeo-inspect.1.md
@@ -95,6 +95,12 @@ The password to access the registry.
 
 Do not list the available tags from the repository in the output. When `true`, the `RepoTags` array will be empty.  Defaults to `false`, which includes all available tags.
 
+**--manifest-digest**=_algorithm_ **EXPERIMENTAL**
+
+Algorithm to use for computing manifest digest (sha256, sha512); defaults to algorithm used in config digest.
+
+**Note:** This flag is experimental and its behavior may change in future releases.
+
 ## EXAMPLES
 
 To review information for the image fedora from the docker.io registry:
@@ -186,6 +192,12 @@ $ /bin/skopeo inspect --format '{{ .Env }}' docker://registry.access.redhat.com/
 [PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin container=oci]
 ```
 
+To get the digest using a specific algorithm:
+```console
+$ skopeo inspect --manifest-digest=sha512 docker://docker.io/library/alpine:latest --format "Digest: {{.Digest}}"
+Digest: sha512:5acb33fb56a7791bf0c69d5b19a1c70272148e4107be5261d57305d14e9509792bbca53e5277c456181ecfa1c20ad8427f9b8ba46868020584a819de1128dbd2
+```
+
 # SEE ALSO
 skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)