Add more descriptive gl-oci tool description.

Signed-off-by: Tobias Wolf <[email protected]>
On-behalf-of: SAP <[email protected]>

Author: NotTheEvilOne

src/gardenlinux/oci/__main__.py

@@ -18,7 +18,9 @@
 @click.group()
 def cli() -> None:
     """
-    gl-oci click argument entrypoint
+    gl-oci provides functionality to handle OCI containers. It can pull and push
+    images from remote repositories as well as handle GardenLinux artifacts, OCI
+    image indices and manifests.
 
     :since: 0.7.0
     """
@@ -182,7 +184,7 @@ def build_container(
 )
 def load_container(oci_archive: str, additional_tag: List[str]) -> None:
     """
-    Push to an OCI registry.
+    Load an OCI archive.
 
     :since: 1.0.0
     """
@@ -208,7 +210,7 @@ def load_container(oci_archive: str, additional_tag: List[str]) -> None:
 )
 def load_containers_from_directory(directory: str) -> None:
     """
-    Push to an OCI registry.
+    Load multiple OCI archives.
 
     :since: 1.0.0
     """
@@ -242,7 +244,7 @@ def load_containers_from_directory(directory: str) -> None:
 )
 def new_index(index: str, index_tag: str, insecure: bool, additional_tag: List[str]) -> None:
     """
-    Push a list of files from the `manifest_folder` to an index.
+    Create a new OCI image index.
 
     :since: 1.0.0
     """
@@ -278,7 +280,7 @@ def new_index(index: str, index_tag: str, insecure: bool, additional_tag: List[s
 )
 def pull_container(container: str, tag: str, platform: str, insecure: bool) -> None:
     """
-    Push to an OCI registry.
+    Pull an OCI image container from a remote OCI registry.
 
     :since: 1.0.0
     """
@@ -311,7 +313,7 @@ def pull_container(container: str, tag: str, platform: str, insecure: bool) -> N
 )
 def push_container(container: str, tag: str, destination: str, insecure: bool) -> None:
     """
-    Push to an OCI registry.
+    Push an OCI image container to a remote OCI registry.
 
     :since: 1.0.0
     """
@@ -466,7 +468,8 @@ def push_manifest(
     additional_tag: List[str],
 ) -> None:
     """
-    Push artifacts and the manifest from a directory to a registry.
+    Push to an OCI image container given GardenLinux canonical named artifacts
+    in a specified directory.
 
     :since: 0.7.0
     """
@@ -538,7 +541,7 @@ def push_manifest_tags(
     tag: List[str],
 ) -> None:
     """
-    Push artifacts and the manifest from a directory to a registry.
+    Push tags to an OCI image container for a given GardenLinux canonical named image.
 
     :since: 0.10.0
     """
@@ -567,7 +570,7 @@ def push_manifest_tags(
 )
 def save_container(container: str, tag: str, oci_archive: str) -> None:
     """
-    Push to an OCI registry.
+    Saves a given OCI image container as an OCI archive.
 
     :since: 1.0.0
     """
@@ -597,7 +600,7 @@ def save_container(container: str, tag: str, oci_archive: str) -> None:
 )
 def tag_container(container: str, tag: str, additional_tag: List[str]) -> None:
     """
-    Push to an OCI registry.
+    Adds additional tags to a given OCI image container.
 
     :since: 1.0.0
     """