Documentation improvements

1 files changed, 13 insertions, 9 deletions

diff --git a/bpkg/pkg-disfigure.cli b/bpkg/pkg-disfigure.cli
index 6f5c80b..51ab956 100644
--- a/bpkg/pkg-disfigure.cli
+++ b/bpkg/pkg-disfigure.cli
@@ -8,20 +8,24 @@ include <bpkg/configuration.cli>;
 "\name=bpkg-pkg-disfigure"
 "\summary=disfigure package"
 
-/*
-"\h{SYNOPSIS}
+namespace bpkg
+{
+  {
+    "<options>",
 
-bpkg pkg-disfigure <pkg> [<ver>]"
+    "\h|SYNOPSIS|
 
-"\h{DESCRIPTION}
+     \c{\b{bpkg pkg-disfigure} [<options>] <pkg>}
 
-The \cb{pkg-disfigure} command disfigures the previously configured
-(\cb{pkg-configure}) package and returns it to the \cb{unpacked} state."
-*/
+     \h|DESCRIPTION|
+
+     The \cb{pkg-disfigure} command disfigures the previously configured
+     (via \l{bpkg-pkg-build(1)} or \l{bpkg-pkg-configure(1)}) package and
+     returns it to the \cb{unpacked} state."
+  }
 
-namespace bpkg
-{
   class pkg_disfigure_options: configuration_options
   {
+    "\h|PKG-DISFIGURE OPTIONS|"
   };
 }