From 6f3a8eda6e656fdaf55bec2539161c1224ae19b2 Mon Sep 17 00:00:00 2001
From: Brett Mayson <brett@mayson.io>
Date: Tue, 21 Nov 2023 19:40:23 +0000
Subject: [PATCH] book

---
 book/SUMMARY.md                  | 45 ++++++++++++++++++--------------
 book/utilities/inspect.md        | 26 ++++++++++++++++++
 book/utilities/pbo/extract.md    | 19 ++++++++++++++
 book/utilities/pbo/inspect.md    | 22 ++++++++++++++++
 book/utilities/pbo/unpack.md     | 20 ++++++++++++++
 book/utilities/signing/verify.md |  4 +--
 6 files changed, 114 insertions(+), 22 deletions(-)
 create mode 100644 book/utilities/inspect.md
 create mode 100644 book/utilities/pbo/extract.md
 create mode 100644 book/utilities/pbo/inspect.md
 create mode 100644 book/utilities/pbo/unpack.md

diff --git a/book/SUMMARY.md b/book/SUMMARY.md
index 314ea508..8a5e2ba0 100644
--- a/book/SUMMARY.md
+++ b/book/SUMMARY.md
@@ -7,38 +7,43 @@
 # Mod Projects
 
 - [Configuration](configuration/index.md)
-    - [Minimum](configuration/minimum.md)
-    - [Version](configuration/version.md)
-    - [Addon](configuration/addon.md)
+  - [Minimum](configuration/minimum.md)
+  - [Version](configuration/version.md)
+  - [Addon](configuration/addon.md)
 - [Commands](commands/index.md)
-    - [new](commands/new.md)
-    - [dev](commands/dev.md)
-    - [launch](commands/launch.md)
-    - [build](commands/build.md)
-    - [release](commands/release.md)
-    - [script](commands/script.md)
+  - [new](commands/new.md)
+  - [dev](commands/dev.md)
+  - [launch](commands/launch.md)
+  - [build](commands/build.md)
+  - [release](commands/release.md)
+  - [script](commands/script.md)
 - [Rhai](rhai/index.md)
-    - [Libraries](rhai/library/index.md)
-        - [Logging](rhai/library/logging.md)
-        - [HEMTT](rhai/library/hemtt.md)
-        - [Project](rhai/library/project.md)
-        - [File System](rhai/library/filesystem.md)
-        - [Time](rhai/library/time.md)
-    - [Hooks](rhai/hooks/index.md)
-        - [Examples](rhai/hooks/examples.md)
-    - [Scripts](rhai/scripts/index.md)
-        - [Examples](rhai/scripts/examples.md)
+  - [Libraries](rhai/library/index.md)
+    - [Logging](rhai/library/logging.md)
+    - [HEMTT](rhai/library/hemtt.md)
+    - [Project](rhai/library/project.md)
+    - [File System](rhai/library/filesystem.md)
+    - [Time](rhai/library/time.md)
+  - [Hooks](rhai/hooks/index.md)
+    - [Examples](rhai/hooks/examples.md)
+  - [Scripts](rhai/scripts/index.md)
+    - [Examples](rhai/scripts/examples.md)
 - [Linting](linting.md)
 - [ArmaScriptCompiler](armascriptcompiler.md)
 
 # Utilities
 
+- [Inspect](utilities/inspect.md)
 - [Verify](utilities/signing/verify.md)
+- [PBO]()
+  - [Inspect](utilities/pbo/inspect.md)
+  - [Extract](utilities/pbo/extract.md)
+  - [Unpack](utilities/pbo/unpack.md)
 
 # Reference
 
 - [Analysis](analysis/index.md)
-    - [Config](analysis/config.md)
+  - [Config](analysis/config.md)
 
 <!--
 # Modding Guide
diff --git a/book/utilities/inspect.md b/book/utilities/inspect.md
new file mode 100644
index 00000000..8f49ee39
--- /dev/null
+++ b/book/utilities/inspect.md
@@ -0,0 +1,26 @@
+# hemtt utils inspect
+
+<pre><code>Provides information about supported files. Supported: pbo, bikey, bisign
+
+Usage: hemtt utils inspect [OPTIONS] &lt;file&gt;
+
+Arguments:
+  &lt;file&gt;
+        File to inspect
+
+Options:
+  -v...
+        Verbosity level
+
+  -h, --help
+        Print help (see a summary with '-h')
+</code>
+</pre>
+
+This will inspect a file and provide information about it.
+
+Currently supported files are:
+
+- .pbo
+- .bikey
+- .bisign
diff --git a/book/utilities/pbo/extract.md b/book/utilities/pbo/extract.md
new file mode 100644
index 00000000..f4764685
--- /dev/null
+++ b/book/utilities/pbo/extract.md
@@ -0,0 +1,19 @@
+# hemtt utils pbo extract
+
+<pre><code>Extract a file from a PBO
+
+Usage: hemtt utils pbo extract [OPTIONS] &lt;pbo&gt; &lt;file&gt; [output]
+
+Arguments:
+  &lt;pbo&gt;     PBO file to extract from
+  &lt;file&gt;    File to extract
+  [output]  Where to save the extracted file
+
+Options:
+  -v...                    Verbosity level
+  -h, --help               Print help
+</code></pre>
+
+Extracts a file from a PBO.
+
+If no output is specified, it will be written to stdout.
diff --git a/book/utilities/pbo/inspect.md b/book/utilities/pbo/inspect.md
new file mode 100644
index 00000000..4f8aa576
--- /dev/null
+++ b/book/utilities/pbo/inspect.md
@@ -0,0 +1,22 @@
+# hemtt utils pbo inspect
+
+<pre><code>Inspect a PBO
+
+Usage: hemtt utils pbo inspect [OPTIONS] &lt;pbo&gt;
+
+Arguments:
+  &lt;pbo&gt;
+        PBO to inspect
+
+Options:
+  -v...
+        Verbosity level
+
+  -h, --help
+        Print help (see a summary with '-h')
+</code>
+</pre>
+
+Provides information about a PBO.
+
+This is the same as `hemtt utils inspect` but will assume the file is a PBO.
diff --git a/book/utilities/pbo/unpack.md b/book/utilities/pbo/unpack.md
new file mode 100644
index 00000000..0dd35549
--- /dev/null
+++ b/book/utilities/pbo/unpack.md
@@ -0,0 +1,20 @@
+# hemtt utils pbo unpack
+
+<pre><code>Unpack a PBO
+
+Usage: hemtt utils pbo unpack [OPTIONS] &lt;pbo&gt; &lt;output&gt;
+
+Arguments:
+  &lt;pbo&gt;     PBO file to unpack
+  &lt;output&gt;  Directory to unpack to
+
+Options:
+  -v...                    Verbosity level
+  -h, --help               Print help
+</code></pre>
+
+Unpacks a PBO to a directory.
+
+A `$PBOPREFIX$` file will be created in the output directory containing the prefix of the PBO.
+
+All other properties from the PBO will be saved into `properties.txt`
diff --git a/book/utilities/signing/verify.md b/book/utilities/signing/verify.md
index e83a0004..0afcb06d 100644
--- a/book/utilities/signing/verify.md
+++ b/book/utilities/signing/verify.md
@@ -5,10 +5,10 @@
 Usage: hemtt utils verify [OPTIONS] &lt;pbo&gt; &lt;bikey&gt;
 
 Arguments:
-  <pbo>
+  &lt;pbo&gt;
           PBO to verify
 
-  <bikey>
+  &lt;bikey&gt;
           BIKey to verify against
 
 Options: