Add docstrings to mkit's functions

mkit/include/common.sh

@@ -6,6 +6,9 @@ bailout() {
 }
 
 build1() {
+    #
+    # Process one skeleton
+    #
     local srcpath dstpath
     srcpath=$1
     dstpath=${srcpath%.skel}
@@ -22,6 +25,9 @@ build1() {
 }
 
 build() {
+    #
+    # Add meat to all skeletons
+    #
     local srcpath
     find -type f -name '*.skel' \
      | while read srcpath;
@@ -51,6 +57,9 @@ configure() {
 }
 
 die() {
+    #
+    # Exit with message and non-zero exit status
+    #
     echo "$@" >&2
     exit 4
 }
@@ -96,6 +105,9 @@ expand_includes() {
 }
 
 expand_groups() {
+    #
+    # Read path groups from paths.ini and expand to install params
+    #
     local group
     local mode
     cat "mkit/paths.ini" \
@@ -109,6 +121,9 @@ expand_groups() {
 }
 
 expand_paths() {
+    #
+    # For each path of group $1, print all install params
+    #
     local group=$1
     local mode=$2
     local root="$(get_root $group)"
@@ -135,6 +150,9 @@ expand_variables() {
 }
 
 get_root() {
+    #
+    # Find out target rooot for group $1
+    #
     local group="$1"
     local varname="${group^^*}_DIR"
     test -n "${!varname}" || die "missing in config.mk: $varname"
@@ -232,6 +250,9 @@ install() {
 }
 
 read_section() {
+    #
+    # Read one INI section
+    #
     local wnt=$1
     local ok=false
     grep '.' \