Implements ./pkgtool.sh -[irt] options.

etc/{README.md,pkgtool.usage}: updated.
subr/ex_pkg.subr:ex_pkg_{find_package,get_packages}(): initial implementation.
subr/ex_pkg.subr:ex_pkg_unfold_{,r}depends(): split from ex_pkg_expand_packages().
subr/ex_pkg{,_dispatch}.subr: removes ${EX_PKG_COMPLETE} scoped global.
subr/ex_pkg_dispatch.subr:exp_pkg_dispatch_expand_packages(): split from subr/ex_pkg.subr.
subr/rtl_list.subr:rtl_lsort(): initial implementation.

1 files changed, 17 insertions, 0 deletions

diff --git a/etc/pkgtool.usage b/etc/pkgtool.usage
new file mode 100644
index 00000000..aeed47b4
--- /dev/null
+++ b/etc/pkgtool.usage
@@ -0,0 +1,17 @@
+usage: ./pkgtool.sh [-a nt32|nt64] [-b debug|release] [-i|-r|-s|-t]
+                    [<variable name>=<variable override>[ ..]] name
+
+        -a nt32|nt64      Selects 32-bit or 64-bit architecture; defaults to nt64.
+        -b debug|release  Selects debug or release build; defaults to debug.
+        -i                List package variables and dependencies of single named package.
+        -r                List reverse dependencies of single named package.
+        -s                Enter interactive package build shell environment for single
+                          named package; requires a package dump file. If the package
+                          has not been built yet or built successfully, it will be rebuilt
+                          at build steps up until, by default, the `build' build step and
+                          forcibly aborted and dumped prior to enterting the shell.
+        -t                Produce tarball of package build root directory and build log
+                          file for the purpose of distribution given build failure.
+
+        <variable name>=<variable override>[ ..]
+                          Override build variable.