Documentation improvements

1 files changed, 14 insertions, 12 deletions

diff --git a/bpkg/cfg-add.cli b/bpkg/cfg-add.cli
index 34909e9..8bc17c3 100644
--- a/bpkg/cfg-add.cli
+++ b/bpkg/cfg-add.cli
@@ -8,23 +8,25 @@ include <bpkg/configuration.cli>;
 "\name=bpkg-cfg-add"
 "\summary=add repository to configuration"
 
-/*
-"\h{SYNOPSIS}
+namespace bpkg
+{
+  {
+    "<options> <rep>",
 
-bpkg cfg-add [<options>] <rep>"
+    "\h|SYNOPSIS|
 
-"\h{DESCRIPTION}
+     \c{\b{bpkg cfg-add}|\b{add} [<options>] <rep>}
 
-The \cb{cfg-add} command adds the specified source repository to the
-configuration. Note that this command doesn't fetch the available
-packages list for the newly added repository. To do that, use the
-\cb{cfg-fetch} command.
-"
-*/
+     \h|DESCRIPTION|
+
+     The \cb{cfg-add} command adds the specified package repository to the
+     configuration. Note that it doesn't fetch the list of available packages
+     for the newly added repository. For that, use the \l{bpkg-cfg-fetch(1)}
+     command, normally, after adding all the repositories you wish to use."
+  }
 
-namespace bpkg
-{
   class cfg_add_options: configuration_options
   {
+    "\h|CFG-ADD OPTIONS|"
   };
 }