From ea6709976c13264f8955f391bbc5fd2cf87800dd Mon Sep 17 00:00:00 2001
From: Lucas <lucas.vancina@nps.edu>
Date: Sat, 9 Sep 2023 20:29:34 -0700
Subject: [PATCH] Added more detailed instructions for win32 builds

---
 doc/NormUserGuide.xml | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/doc/NormUserGuide.xml b/doc/NormUserGuide.xml
index 43af05c..32f1782 100755
--- a/doc/NormUserGuide.xml
+++ b/doc/NormUserGuide.xml
@@ -96,8 +96,9 @@
 
       <orderedlist>
         <listitem>
-            <para>Download and unpack the NORM source code tarball or clone the
-            repository using <literal>git clone --recurse-submodules https://github.com/USNavalResearchLaboratory/norm.git</literal></para>
+            <para>Download and unpack the NORM source code tarball or clone the github
+            repository using 
+            <literal>git clone --recurse-submodules https://github.com/USNavalResearchLaboratory/norm.git</literal></para>
         </listitem>
 
         <listitem>
@@ -119,7 +120,8 @@
 
       <orderedlist>
         <listitem>
-          <para>Download and unpack the NORM source code tarball</para>
+            <para>Download and unpack the NORM source code tarball or clone the
+        repository as described in the section above.</para>
         </listitem>
 
         <listitem>
@@ -129,7 +131,7 @@
         </listitem>
 
         <listitem>
-          <para>Open the "<filename>norm.sln</filename>" (VC++ .Net),
+            <para>Inside the "<filename>norm/makefiles/win32</filename>" directory, open the "<filename>norm.sln</filename>" (VC++ .Net),
           "<filename>norm.dsw</filename>" (VC++ 6.0), or
           "<filename>norm.vcw</filename>" (Embedded VC++) workspace
           file.</para>
@@ -141,6 +143,11 @@
           the "<filename>norm/win32/norm/Release</filename>" directory.</para>
         </listitem>
       </orderedlist>
+      <para>The easiest way to run these builds is with Visual Studio. If you do not already have Visual Studio installed, then it can
+      be downloaded for free <ulink url="https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta">here</ulink>.
+      When you launch Visual Studio, make sure to select "Visual C++" and open the "<filename>norm.sln</filename>" file.
+      This should load all of the project files and allow you to right click on any of them in the Solution Explorer on the
+      left side and select "build".</para>
     </sect2>
   </sect1>