From 1c13ae4ed5d84b32c2c1a0698f9e688c312de989 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Mon, 11 Jan 2016 15:14:32 +0200
Subject: Documentation improvements

---
 bpkg/cfg-fetch.cli | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

(limited to 'bpkg/cfg-fetch.cli')

diff --git a/bpkg/cfg-fetch.cli b/bpkg/cfg-fetch.cli
index 6b889cc..9cc75fd 100644
--- a/bpkg/cfg-fetch.cli
+++ b/bpkg/cfg-fetch.cli
@@ -6,23 +6,27 @@ include <bpkg/configuration.cli>;
 
 "\section=1"
 "\name=bpkg-cfg-fetch"
-"\summary=fetch available packages list"
+"\summary=fetch list of available packages"
 
-/*
-"\h{SYNOPSIS}
+namespace bpkg
+{
+  {
+    "<options>",
 
-bpkg cfg-fetch [<options>]"
+    "\h|SYNOPSIS|
 
-"\h{DESCRIPTION}
+     \c{\b{bpkg cfg-fetch}|\b{fetch} [<options>]}
 
-The \cb{cfg-fetch} command recursively fetches the prerequisite repository
-and available package lists for all the repositories that were added
-(\cb{cfg-add}) to the configuration."
-*/
+     \h|DESCRIPTION|
+
+     The \cb{cfg-fetch} command fetches the list of available packages for all
+     the repositories that were previously added with the \l{bpkg-cfg-add(1)}
+     command as well as all their complement and prerequisite repositories,
+     recursively."
+  }
 
-namespace bpkg
-{
   class cfg_fetch_options: configuration_options
   {
+    "\h|CFG-FETCH OPTIONS|"
   };
 }
-- 
cgit v1.1