Comment extravaganza

Author: dhrdlicka

86BoxManager/FolderSelectDialog.cs

@@ -1,4 +1,4 @@
-#if !NETCOREAPP
+#if !NETCOREAPP // Not required for .NET Core builds
 using System;
 using System.Reflection;
 using System.Windows.Forms;

86BoxManager/dlgAddVM.cs

@@ -74,6 +74,7 @@ private void txtName_TextChanged(object sender, EventArgs e)
             }
         }
 
+// .NET Core implements the better Vista-style folder browse dialog in the stock FolderBrowserDialog
 #if NETCOREAPP
         private void btnBrowse_Click(object sender, EventArgs e)
         {
@@ -90,6 +91,7 @@ private void btnBrowse_Click(object sender, EventArgs e)
                 txtName.Text = Path.GetFileName(dialog.SelectedPath);
             }
         }
+// A custom class is required for Vista-style folder dialogs under the original .NET Framework
 #else
         private void btnBrowse_Click(object sender, EventArgs e)
         {

86BoxManager/dlgSettings.cs

@@ -235,6 +235,7 @@ private void LoadSettings()
             }
         }
 
+// .NET Core implements the better Vista-style folder browse dialog in the stock FolderBrowserDialog
 #if NETCOREAPP
         private void btnBrowse1_Click(object sender, EventArgs e)
         {
@@ -273,6 +274,7 @@ private void btnBrowse2_Click(object sender, EventArgs e)
                 }
             }
         }
+// A custom class is required for Vista-style folder dialogs under the original .NET Framework
 #else
         private void btnBrowse1_Click(object sender, EventArgs e)
         {

86BoxManager/frmMain.cs

@@ -1,4 +1,4 @@
-#if !NETCOREAPP
+#if !NETCOREAPP // COM references require .NET framework for now
 using IWshRuntimeLibrary;
 #endif
 using Microsoft.Win32;
@@ -53,7 +53,7 @@ public frmMain()
             LoadVMs();
 
 #if NETCOREAPP
-            createADesktopShortcutToolStripMenuItem.Enabled = false;
+            createADesktopShortcutToolStripMenuItem.Enabled = false; // Requires the original .NET framework
 #endif
         }
 
@@ -1136,7 +1136,7 @@ private void VMOpenFolder()
 
         private void createADesktopShortcutToolStripMenuItem_Click(object sender, EventArgs e)
         {
-#if !NETCOREAPP
+#if !NETCOREAPP // Requires the original .NET Framework
             VM vm = (VM)lstVMs.SelectedItems[0].Tag;
             WshShell shell = new WshShell();
             string shortcutAddress = Environment.GetFolderPath(Environment.SpecialFolder.Desktop) + @"\" + vm.Name + ".lnk";