Make doc() return arbitrary Markdown rather than the contents of the "Description" section

Thus we can return the examples section (and any other sections) from
doc() and don't need examples() anymore.

1 files changed, 20 insertions, 6 deletions

diff --git a/src/nix/add-to-store.cc b/src/nix/add-to-store.cc
index df51e72d5..022f0ea85 100644
--- a/src/nix/add-to-store.cc
+++ b/src/nix/add-to-store.cc
@@ -39,15 +39,29 @@ 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.
-        )";
-    }
 
-    Examples examples() override
-    {
-        return {
-        };
+          > **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
+          ```
+        )";
     }
 
     Category category() override { return catUtility; }