From d0842f4a05ac691dc296347ff872eb7a9b83b42d Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Wed, 28 Aug 2019 14:45:15 +0300
Subject: Add/update some module descriptions

---
 libbuild2/bash/init.hxx    | 2 +-
 libbuild2/config/init.hxx  | 5 +++++
 libbuild2/dist/init.hxx    | 5 +++++
 libbuild2/in/init.hxx      | 3 ++-
 libbuild2/install/init.hxx | 6 ++++++
 libbuild2/test/init.hxx    | 5 +++++
 libbuild2/version/init.hxx | 2 +-
 7 files changed, 25 insertions(+), 3 deletions(-)

(limited to 'libbuild2')

diff --git a/libbuild2/bash/init.hxx b/libbuild2/bash/init.hxx
index 4d05f2d..d8275df 100644
--- a/libbuild2/bash/init.hxx
+++ b/libbuild2/bash/init.hxx
@@ -18,7 +18,7 @@ namespace build2
   {
     // Module `bash` does not require bootstrapping.
     //
-    // No submodules.
+    // `bash` -- registers variables, target types, and rules.
     //
     extern "C" LIBBUILD2_BASH_SYMEXPORT const module_functions*
     build2_bash_load ();
diff --git a/libbuild2/config/init.hxx b/libbuild2/config/init.hxx
index f900801..d6a1e08 100644
--- a/libbuild2/config/init.hxx
+++ b/libbuild2/config/init.hxx
@@ -28,6 +28,11 @@ namespace build2
           bool,
           const variable_map&);
 
+    // Module `config` requires bootstrapping.
+    //
+    // `config` -- registers the configure and disfigure meta-operations,
+    //             registers variables, and sources the config.build file.
+    //
     extern "C" LIBBUILD2_SYMEXPORT const module_functions*
     build2_config_load ();
   }
diff --git a/libbuild2/dist/init.hxx b/libbuild2/dist/init.hxx
index cfcb3af..ffaa91d 100644
--- a/libbuild2/dist/init.hxx
+++ b/libbuild2/dist/init.hxx
@@ -28,6 +28,11 @@ namespace build2
           bool,
           const variable_map&);
 
+    // Module `dist` requires bootstrapping.
+    //
+    // `dist` -- registers the dist meta-operation, registers/sets variables,
+    //           and registers rules.
+    //
     extern "C" LIBBUILD2_SYMEXPORT const module_functions*
     build2_dist_load ();
   }
diff --git a/libbuild2/in/init.hxx b/libbuild2/in/init.hxx
index b82c77e..29e3e61 100644
--- a/libbuild2/in/init.hxx
+++ b/libbuild2/in/init.hxx
@@ -20,7 +20,8 @@ namespace build2
     //
     // Submodules:
     //
-    // `in.base`  -- only variables and target types.
+    // `in.base` -- registers variables and target types.
+    // `in`      -- loads in.base and registers rules.
     //
     extern "C" LIBBUILD2_IN_SYMEXPORT const module_functions*
     build2_in_load ();
diff --git a/libbuild2/install/init.hxx b/libbuild2/install/init.hxx
index b2daea0..353b24b 100644
--- a/libbuild2/install/init.hxx
+++ b/libbuild2/install/init.hxx
@@ -28,6 +28,12 @@ namespace build2
           bool,
           const variable_map&);
 
+    // Module `install` requires bootstrapping.
+    //
+    // `install` -- registers the install, uninstall, and update-for-install
+    //              operations, registers/sets variables, and registers
+    //              functions and rules.
+    //
     extern "C" LIBBUILD2_SYMEXPORT const module_functions*
     build2_install_load ();
   }
diff --git a/libbuild2/test/init.hxx b/libbuild2/test/init.hxx
index 57f6bfa..49cdb14 100644
--- a/libbuild2/test/init.hxx
+++ b/libbuild2/test/init.hxx
@@ -28,6 +28,11 @@ namespace build2
           bool,
           const variable_map&);
 
+    // Module `test` requires bootstrapping.
+    //
+    // `test` -- registers the test and update-for-test operations, registers/
+    //           sets variables, and registers target types and rules.
+    //
     extern "C" LIBBUILD2_SYMEXPORT const module_functions*
     build2_test_load ();
   }
diff --git a/libbuild2/version/init.hxx b/libbuild2/version/init.hxx
index 68e4def..fe194f3 100644
--- a/libbuild2/version/init.hxx
+++ b/libbuild2/version/init.hxx
@@ -18,7 +18,7 @@ namespace build2
   {
     // Module `version` requires bootstrapping.
     //
-    // No submodules.
+    // `version` -- registers variables, target types, and rules.
     //
     extern "C" LIBBUILD2_VERSION_SYMEXPORT const module_functions*
     build2_version_load ();
-- 
cgit v1.1