From 654d68ce36c6785644265c680d243b1e05661dd6 Mon Sep 17 00:00:00 2001
From: "Lixia (Sylvia) Lei" <lixlei@microsoft.com>
Date: Tue, 3 Dec 2024 19:07:42 +0800
Subject: [PATCH] uppdate docs

Signed-off-by: Lixia (Sylvia) Lei <lixlei@microsoft.com>
---
 cmd/oras/root/attach.go        | 3 ++-
 cmd/oras/root/blob/push.go     | 3 ++-
 cmd/oras/root/cp.go            | 3 ++-
 cmd/oras/root/manifest/push.go | 3 ++-
 cmd/oras/root/pull.go          | 3 ++-
 5 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/cmd/oras/root/attach.go b/cmd/oras/root/attach.go
index 20dea147e..a87d3c195 100644
--- a/cmd/oras/root/attach.go
+++ b/cmd/oras/root/attach.go
@@ -44,7 +44,8 @@ type attachOptions struct {
 
 	artifactType string
 	concurrency  int
-	verbose      bool // deprecated
+	// Deprecated: verbose is deprecated and will be removed in the future.
+	verbose bool
 }
 
 func attachCmd() *cobra.Command {
diff --git a/cmd/oras/root/blob/push.go b/cmd/oras/root/blob/push.go
index 4e849b097..883de2fe5 100644
--- a/cmd/oras/root/blob/push.go
+++ b/cmd/oras/root/blob/push.go
@@ -42,7 +42,8 @@ type pushBlobOptions struct {
 	fileRef   string
 	mediaType string
 	size      int64
-	verbose   bool // deprecated
+	// Deprecated: verbose is deprecated and will be removed in the future.
+	verbose bool
 }
 
 func pushCmd() *cobra.Command {
diff --git a/cmd/oras/root/cp.go b/cmd/oras/root/cp.go
index d1bc073f6..39c997398 100644
--- a/cmd/oras/root/cp.go
+++ b/cmd/oras/root/cp.go
@@ -53,7 +53,8 @@ type copyOptions struct {
 	recursive   bool
 	concurrency int
 	extraRefs   []string
-	verbose     bool // deprecated
+	// Deprecated: verbose is deprecated and will be removed in the future.
+	verbose bool
 }
 
 func copyCmd() *cobra.Command {
diff --git a/cmd/oras/root/manifest/push.go b/cmd/oras/root/manifest/push.go
index f612be313..7fea60046 100644
--- a/cmd/oras/root/manifest/push.go
+++ b/cmd/oras/root/manifest/push.go
@@ -48,7 +48,8 @@ type pushOptions struct {
 	extraRefs   []string
 	fileRef     string
 	mediaType   string
-	verbose     bool // deprecated
+	// Deprecated: verbose is deprecated and will be removed in the future.
+	verbose bool
 }
 
 func pushCmd() *cobra.Command {
diff --git a/cmd/oras/root/pull.go b/cmd/oras/root/pull.go
index d77a74ebf..c26745b68 100644
--- a/cmd/oras/root/pull.go
+++ b/cmd/oras/root/pull.go
@@ -52,7 +52,8 @@ type pullOptions struct {
 	PathTraversal     bool
 	Output            string
 	ManifestConfigRef string
-	verbose           bool // deprecated
+	// Deprecated: verbose is deprecated and will be removed in the future.
+	verbose bool
 }
 
 func pullCmd() *cobra.Command {