From 1b0ca3866bae7185e628fda956634c52a5da7a15 Mon Sep 17 00:00:00 2001
From: Eelco Dolstra <edolstra@gmail.com>
Date: Thu, 3 Dec 2020 14:23:18 +0100
Subject: [PATCH] nix add-to-store: Move markdown docs into a separate file

---
 src/nix/add-to-store.cc | 27 +++------------------------
 src/nix/add-to-store.md | 28 ++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+), 24 deletions(-)
 create mode 100644 src/nix/add-to-store.md

diff --git a/src/nix/add-to-store.cc b/src/nix/add-to-store.cc
index 022f0ea85..a2721431e 100644
--- a/src/nix/add-to-store.cc
+++ b/src/nix/add-to-store.cc
@@ -38,30 +38,9 @@ struct CmdAddToStore : MixDryRun, StoreCommand
 
     std::string doc() override
     {
-        return R"(
-          # Description
-
-          Copy the file or directory *path* to the Nix store, and
-          print the resulting store path on standard output.
-
-          > **Warning**
-          >
-          > The resulting store path is not registered as a garbage
-          > collector root, so it could be deleted before you have a
-          > chance to register it.
-
-          # Examples
-
-          Add a regular file to the store:
-
-          ```console
-          # echo foo > bar
-          # nix add-to-store --flat ./bar
-          /nix/store/cbv2s4bsvzjri77s2gb8g8bpcb6dpa8w-bar
-          # cat /nix/store/cbv2s4bsvzjri77s2gb8g8bpcb6dpa8w-bar
-          foo
-          ```
-        )";
+        return
+          #include "add-to-store.md"
+          ;
     }
 
     Category category() override { return catUtility; }
diff --git a/src/nix/add-to-store.md b/src/nix/add-to-store.md
new file mode 100644
index 000000000..593ad67ad
--- /dev/null
+++ b/src/nix/add-to-store.md
@@ -0,0 +1,28 @@
+R""(
+
+# Description
+
+Copy the file or directory *path* to the Nix store, and
+print the resulting store path on standard output.
+
+> **Warning**
+>
+> The resulting store path is not registered as a garbage
+> collector root, so it could be deleted before you have a
+> chance to register it.
+
+# Examples
+
+Add a regular file to the store:
+
+```console
+# echo foo > bar
+
+# nix add-to-store --flat ./bar
+/nix/store/cbv2s4bsvzjri77s2gb8g8bpcb6dpa8w-bar
+
+# cat /nix/store/cbv2s4bsvzjri77s2gb8g8bpcb6dpa8w-bar
+foo
+```
+
+)""