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-configure.cli | 28 +++++++++++++++-------------
 1 file changed, 15 insertions(+), 13 deletions(-)

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

diff --git a/bpkg/pkg-configure.cli b/bpkg/pkg-configure.cli
index 4ef9707..274a3c3 100644
--- a/bpkg/pkg-configure.cli
+++ b/bpkg/pkg-configure.cli
@@ -8,24 +8,26 @@ include <bpkg/configuration.cli>;
 "\name=bpkg-pkg-configure"
 "\summary=configure package"
 
-/*
-"\h{SYNOPSIS}
+namespace bpkg
+{
+  {
+    "<options> <pkg> <conf-var>",
 
-bpkg pkg-configure <pkg> [<conf-vars>]"
+    "\h|SYNOPSIS|
 
-"\h{DESCRIPTION}
+     \c{\b{bpkg pkg-configure} [<options>] <pkg> [<conf-var>...]}
 
-The \cb{pkg-configure} command configures the output directory for
-the previously unpacked (\cb{pkg-unpack}) package. The package
-inherits the common \cb{build2} configuration values that were
-specified when creating the \cb{bpkg} configuration (\cb{cfg-create}).
-Additional, package-specific configuration variables can be specified
-after the package name."
-*/
+     \h|DESCRIPTION|
+
+     The \cb{pkg-configure} command configures the previously unpacked
+     (\l{bpkg-pkg-unpack(1)}) package. The package inherits the common
+     \cb{build2} configuration values that were specified when creating the
+     configuration (\l{bpkg-cfg-create(1)}). Additional, package-specific
+     configuration variables can be specified after the package name."
+  }
 
-namespace bpkg
-{
   class pkg_configure_options: configuration_options
   {
+    "\h|PKG-CONFIGURE OPTIONS|"
   };
 }
-- 
cgit v1.1