From 3181090230ca3903ed7f02c3d91ecf82b57a3eec Mon Sep 17 00:00:00 2001
From: joshbaker22 <141415098+joshbaker22@users.noreply.github.com>
Date: Mon, 14 Aug 2023 14:06:57 -0400
Subject: [PATCH] add man pages for ae2dir and viewdir

---
 doc/docbook/system/mann/CMakeLists.txt |  2 +
 doc/docbook/system/mann/ae2dir.xml     | 60 ++++++++++++++++++++++++++
 doc/docbook/system/mann/qvrot.xml      |  5 ++-
 doc/docbook/system/mann/viewdir.xml    | 56 ++++++++++++++++++++++++
 4 files changed, 122 insertions(+), 1 deletion(-)
 create mode 100644 doc/docbook/system/mann/ae2dir.xml
 create mode 100644 doc/docbook/system/mann/viewdir.xml

diff --git a/doc/docbook/system/mann/CMakeLists.txt b/doc/docbook/system/mann/CMakeLists.txt
index cec6af42c80..c4b1f387798 100644
--- a/doc/docbook/system/mann/CMakeLists.txt
+++ b/doc/docbook/system/mann/CMakeLists.txt
@@ -6,6 +6,7 @@ set(mann_EN
   Z.xml
   adc.xml
   ae.xml
+  ae2dir.xml
   analyze.xml
   animmate.xml
   apropos.xml
@@ -229,6 +230,7 @@ set(mann_EN
   vars.xml
   vdraw.xml
   view.xml
+  viewdir.xml
   viewsize.xml
   vnirt.xml
   voxelize.xml
diff --git a/doc/docbook/system/mann/ae2dir.xml b/doc/docbook/system/mann/ae2dir.xml
new file mode 100644
index 00000000000..4031517315c
--- /dev/null
+++ b/doc/docbook/system/mann/ae2dir.xml
@@ -0,0 +1,60 @@
+<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="viewdir">
+
+<refmeta>
+  <refentrytitle>VIEWDIR</refentrytitle>
+  <manvolnum>nged</manvolnum>
+  <refmiscinfo class="source">BRL-CAD</refmiscinfo>
+  <refmiscinfo class="manual">BRL-CAD MGED Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv xml:id="name">
+  <refname>viewdir</refname>
+  <refpurpose>Returns the direction vector using the provided azimuth and elevation (AE).
+   </refpurpose>
+</refnamediv>
+
+<!-- body begins here -->
+<refsynopsisdiv xml:id="synopsis">
+  <cmdsynopsis sepchar=" ">
+    <command>viewdir</command>
+    <arg choice="opt" rep="norepeat">-i</arg>
+    <arg choice="req" rep="norepeat"><replaceable>azimuth</replaceable></arg>
+    <arg choice="req" rep="norepeat"><replaceable>elevation</replaceable></arg>
+  </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection xml:id="description"><title>DESCRIPTION</title>
+
+  <para>Returns the direction vector using the provided azimuth and elevation as input. The
+  <emphasis>-i</emphasis> option results in the angles supplied being interpreted as increments.
+  See also the <command>viewdir</command> and <command>qvrot</command> commands.
+
+  </para>
+</refsection>
+
+<refsection xml:id="examples"><title>EXAMPLES</title>
+
+  <para>The example shows the use of the <command>ae2dir</command> command to get the direction vector.
+
+  </para>
+  <example><title>Find the direction vector using the provided azimuth and elevation.</title>
+
+    <para>
+	     <prompt>mged&gt; </prompt><userinput>ae2dir 35 25</userinput>
+    </para>
+    <para>Returns the direction vector using an azimuth of 35 and elevation of 25.
+     </para>
+  </example>
+
+  </refsection>
+
+<refsection xml:id="author"><title>AUTHOR</title><para>BRL-CAD Team</para></refsection>
+
+<refsection xml:id="bug_reports"><title>BUG REPORTS</title>
+
+  <para>
+    Reports of bugs or problems should be submitted via electronic
+    mail to <email>devs@brlcad.org</email>
+  </para>
+</refsection>
+</refentry>
diff --git a/doc/docbook/system/mann/qvrot.xml b/doc/docbook/system/mann/qvrot.xml
index 4089fb6cacb..b63c9627b92 100644
--- a/doc/docbook/system/mann/qvrot.xml
+++ b/doc/docbook/system/mann/qvrot.xml
@@ -27,7 +27,10 @@
 <refsection xml:id="description"><title>DESCRIPTION</title>
 
   <para>Adjusts the current MGED viewing direction such that the eye
-	is positioned along the direction vector (<emphasis>dx dy dz</emphasis>) from the view center and is 	looking towards the view center. The <emphasis>angle</emphasis> (in degrees) allows for a twist about the 	viewing direction. The <command>ae</command> command provides a similar capability.
+	is positioned along the direction vector (<emphasis>dx dy dz</emphasis>) from the view center and is
+  looking towards the view center. The <emphasis>angle</emphasis> (in degrees) allows for a twist about the
+  viewing direction. The <command>ae</command> command provides a similar capability. See also the
+  <command>ae2dir</command> and <command>viewdir</command> commands.
   </para>
 </refsection>
 
diff --git a/doc/docbook/system/mann/viewdir.xml b/doc/docbook/system/mann/viewdir.xml
new file mode 100644
index 00000000000..caddf090d6d
--- /dev/null
+++ b/doc/docbook/system/mann/viewdir.xml
@@ -0,0 +1,56 @@
+<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="viewdir">
+
+<refmeta>
+  <refentrytitle>VIEWDIR</refentrytitle>
+  <manvolnum>nged</manvolnum>
+  <refmiscinfo class="source">BRL-CAD</refmiscinfo>
+  <refmiscinfo class="manual">BRL-CAD MGED Commands</refmiscinfo>
+</refmeta>
+
+<refnamediv xml:id="name">
+  <refname>viewdir</refname>
+  <refpurpose>Returns the direction vector using the current azimuth and elevation (AE).
+   </refpurpose>
+</refnamediv>
+
+<!-- body begins here -->
+<refsynopsisdiv xml:id="synopsis">
+  <cmdsynopsis sepchar=" ">
+    <command>viewdir</command>
+  </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection xml:id="description"><title>DESCRIPTION</title>
+
+  <para>Returns the direction vector using the current azimuth and elevation as input. See also the
+  <command>ae2dir</command> and <command>qvrot</command> commands.
+
+  </para>
+</refsection>
+
+<refsection xml:id="examples"><title>EXAMPLES</title>
+
+  <para>The example shows the use of the <command>viewdir</command> command to get the direction vector.
+
+  </para>
+  <example><title>Find the current direction vector.</title>
+
+    <para>
+	     <prompt>mged&gt; </prompt><userinput>viewdir</userinput>
+    </para>
+    <para>Returns the direction vector using the current azimuth and elevation.
+     </para>
+  </example>
+
+  </refsection>
+
+<refsection xml:id="author"><title>AUTHOR</title><para>BRL-CAD Team</para></refsection>
+
+<refsection xml:id="bug_reports"><title>BUG REPORTS</title>
+
+  <para>
+    Reports of bugs or problems should be submitted via electronic
+    mail to <email>devs@brlcad.org</email>
+  </para>
+</refsection>
+</refentry>