From 2e9b7c4cb2168f0aac8948d3212e50726b37acdd Mon Sep 17 00:00:00 2001
From: Eelco Dolstra <edolstra@gmail.com>
Date: Thu, 7 Sep 2017 20:09:04 +0200
Subject: [PATCH] nix run: Add some examples

---
 src/nix/run.cc | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/nix/run.cc b/src/nix/run.cc
index 64a5cbd30..31c3c1464 100644
--- a/src/nix/run.cc
+++ b/src/nix/run.cc
@@ -70,6 +70,24 @@ struct CmdRun : InstallablesCommand
         return "run a shell in which the specified packages are available";
     }
 
+    Examples examples() override
+    {
+        return {
+            Example{
+                "To start a shell providing GNU Hello from NixOS 17.03:",
+                "nix run -f channel:nixos-17.03 hello"
+            },
+            Example{
+                "To start a shell providing youtube-dl from your 'nixpkgs' channel:",
+                "nix run nixpkgs.youtube-dl"
+            },
+            Example{
+                "To run GNU Hello:",
+                "nix run nixpkgs.hello -c hello --greeting 'Hi everybody!'"
+            },
+        };
+    }
+
     void run(ref<Store> store) override
     {
         auto outPaths = toStorePaths(store, Build);