docs/cli: add some more

docs/cli.rst

@@ -7,3 +7,4 @@ CLI Reference
    cli/std-image-options
    cli/cascade
    cli/study-sample-image-tiles
+   cli/wwtl-sample-image-tiles

docs/cli/cascade.rst

@@ -1,3 +1,5 @@
+.. _cli-cascade:
+
 ==================
 ``toasty cascade``
 ==================

docs/cli/study-sample-image-tiles.rst

@@ -1,3 +1,5 @@
+.. _cli-study-sample-image-tiles:
+
 ===================================
 ``toasty study-sample-image-tiles``
 ===================================
@@ -23,3 +25,10 @@ that needs to be tiled to be displayed usefully in AAS WorldWide Telescope.
 
 The ``--outdir DIR`` option specifies where the output data should be written.
 If unspecified, the data root will be the current directory.
+
+Notes
+=====
+
+If the input image does not contain any useful astrometric information, the
+emited ``index_rel.wtml`` file will contain generic information that makes the
+image 1° wide and places it at RA = Dec = 0.

docs/cli/wwtl-sample-image-tiles.rst

@@ -0,0 +1,35 @@
+.. _cli-wwtl-sample-image-tiles:
+
+==================================
+``toasty wwtl-sample-image-tiles``
+==================================
+
+The ``wwtl-sample-image-tiles`` command is like
+:ref:`cli-study-sample-image-tiles`, but loads up ``.wwtl`` WWT “layers” files,
+from which it can load preexisting astrometric information and convert it to the
+format needed for its tiled output. The purpose of this specialized command is
+to enable an easy workflow where you can interactively position a large image
+file on the sky in the AAS WorldWide Telescope Windows application, then tile it
+for web viewing while preserving the astrometric alignment.
+
+Usage
+=====
+
+.. code-block:: shell
+
+   toasty wwtl-sample-image-tiles
+      [standard image-loading options]
+      [--outdir DIR]
+      WWTL-PATH
+
+See the :ref:`cli-std-image-options` section for documentation on those options.
+Note that options that deal with image processing will process the image
+contained in the input WWTL file. Other options might not make sense for this
+command.
+
+The ``WWTL-PATH`` argument gives the filename of the input WWTL file. This file
+should contain one layer, which should be an image-set layer. The WWTL file will
+include the contents of the associated image as well.
+
+The ``--outdir DIR`` option specifies where the output data should be written.
+If unspecified, the data root will be the current directory.