Docs

Author: rm-dr

docs/src/v2cli/show.md

@@ -34,3 +34,33 @@ $ tectonic -X show user-cache-dir
 $ tectonic -X show user-cache-dir
 C:\Users\knuth\AppData\Local\TectonicProject\Tectonic # Windows
 ```
+
+
+## tectonic -X show metadata
+
+Read metadata from the current workspace. Great for automated scripts!
+
+#### Usage Synopsis
+
+Given a `Tectonic.toml` that contains the following:
+
+```toml
+[doc.metadata]
+title = "Title"
+arr = [1, 2, [6, 7]]
+```
+
+
+```sh
+$ tectonic -X show metadata title
+Title
+
+$ tectonic -X show metadata arr.len
+3
+
+$ tectonic -X show metadata arr.2.0
+6
+```
+
+Note that `tectonic -X show metadata arr` returns an error.
+Lists and tables may not be accessed directly.