From b5aeaa243b52fc38a83040d811e95379ce3534bd Mon Sep 17 00:00:00 2001
From: Debarshi Ray <rishi@fedoraproject.org>
Date: Mon, 25 Sep 2023 20:03:32 +0200
Subject: [PATCH] doc/toolbox: Add a usage section

... similar to the website:
  https://containertoolbx.org/install/

As suggested by Sumantro Mukherjee.

https://github.com/containers/toolbox/pull/1379
---
 doc/toolbox.1.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/doc/toolbox.1.md b/doc/toolbox.1.md
index b6e57e1..651594d 100644
--- a/doc/toolbox.1.md
+++ b/doc/toolbox.1.md
@@ -64,6 +64,33 @@ fedora |\<release\> or f\<release\> eg., 36 or f36
 rhel   |\<major\>.\<minor\> eg., 8.5
 ubuntu |\<YY\>.\<MM\> eg., 22.04
 
+## USAGE
+
+### Create a Toolbox container:
+
+```
+[user@hostname ~]$ toolbox create
+Image required to create toolbox container.
+Download registry.fedoraproject.org/fedora-toolbox:36 (294.1MB)? [y/N]: y
+Created container: fedora-toolbox-36
+Enter with: toolbox enter
+[user@hostname ~]$
+```
+
+### Enter the Toolbox container:
+
+```
+[user@hostname ~]$ toolbox enter
+⬢[user@toolbox ~]$
+```
+
+### Remove the Toolbox container:
+
+```
+[user@hostname ~]$ toolbox rm fedora-toolbox-36
+[user@hostname ~]$
+```
+
 ## GLOBAL OPTIONS ##
 
 The following options are understood: