From 90b7e4c00b0fab3edcc5aedaa29581b5b589793f Mon Sep 17 00:00:00 2001
From: Dominik Picheta <dominikpicheta@googlemail.com>
Date: Sat, 22 Oct 2022 23:57:25 +0100
Subject: [PATCH] Documents usage of choosenim in more detail

Fixes #3
---
 readme.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/readme.md b/readme.md
index bc818fe..abe055e 100644
--- a/readme.md
+++ b/readme.md
@@ -11,7 +11,9 @@ The aim of this tool is two-fold:
 
 ## Typical usage
 
-```
+To select the current `stable` release of Nim:
+
+```bash
 $ choosenim stable
   Installed component 'nim'
   Installed component 'nimble'
@@ -24,6 +26,29 @@ $ nim -v
 Nim Compiler Version 1.0.0 [Linux: amd64]
 ```
 
+To update to the latest `stable` release of Nim:
+
+```bash
+$ choosenim update stable
+```
+
+To display which versions are currently installed:
+
+```bash
+$ choosenim show
+  Selected: 1.6.6
+   Channel: stable
+      Path: /home/dom/.choosenim/toolchains/nim-1.6.6
+
+  Versions:
+            #devel
+          * 1.6.6
+            1.0.0
+            #v1.0.0
+```
+
+Versions can be selected via `choosenim 1.6.6` or by branch/tag name via `choosenim #devel` (note that selecting branches is likely to require Nim to be bootstrapped which may be slow).
+
 ## Installation
 
 ### Windows