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/pkg-update.cli | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

(limited to 'bpkg/pkg-update.cli')

diff --git a/bpkg/pkg-update.cli b/bpkg/pkg-update.cli
index 09a5f59..cce17b0 100644
--- a/bpkg/pkg-update.cli
+++ b/bpkg/pkg-update.cli
@@ -8,21 +8,24 @@ include <bpkg/configuration.cli>;
 "\name=bpkg-pkg-update"
 "\summary=update package"
 
-/*
-"\h{SYNOPSIS}
+namespace bpkg
+{
+  {
+    "<options> <pkg>",
 
-bpkg pkg-update <pkg>..."
+    "\h|SYNOPSIS|
 
-"\h{DESCRIPTION}
+     \c{\b{bpkg pkg-update}|\b{update} [<options>] <pkg>...}
 
-The \cb{pkg-update} command updates the previously configured
-(\cb{pkg-configure}) package. Underneath, this command doesn't
-do much more than run (\cb{b update})."
-*/
+     \h|DESCRIPTION|
+
+     The \cb{pkg-update} command updates the previously configured
+     (via \l{bpkg-pkg-build(1)} or \l{bpkg-pkg-configure(1)}) package.
+     Underneath, this command doesn't do much more than run \cb{b update}."
+  }
 
-namespace bpkg
-{
   class pkg_update_options: configuration_options
   {
+    "\h|PKG-UPDATE OPTIONS|"
   };
 }
-- 
cgit v1.1