Documented the purpose of various perl modules.

lib/Slic3r/GUI/2DBed.pm

@@ -1,3 +1,5 @@
+# Bed shape dialog
+
 package Slic3r::GUI::2DBed;
 use strict;
 use warnings;

lib/Slic3r/GUI/3DScene.pm

@@ -1347,6 +1347,8 @@ sub _expolygons_to_verts {
     gluDeleteTess($tess);
 }
 
+# Fill in the $qverts and $tverts with quads and triangles
+# for the extrusion $entity.
 sub _extrusionentity_to_verts {
     my ($self, $entity, $top_z, $copy, $qverts, $tverts) = @_;
     
@@ -1379,8 +1381,16 @@ sub _extrusionentity_to_verts {
         }
     }
     # Calling the C++ implementation Slic3r::_3DScene::_extrusionentity_to_verts_do()
+    # This adds new vertices to the $qverts and $tverts.
     Slic3r::GUI::_3DScene::_extrusionentity_to_verts_do($lines, $widths, $heights,
-        $closed, $top_z, $copy, $qverts, $tverts);
+        $closed, 
+        # Top height of the extrusion.
+        $top_z, 
+        # $copy is not used here.
+        $copy,
+        # GLVertexArray object: C++ class maintaining an std::vector<float> for coords and normals.
+        $qverts,
+        $tverts);
 }
 
 sub object_idx {

lib/Slic3r/GUI/BedShapeDialog.pm

@@ -1,3 +1,6 @@
+# The bed shape dialog.
+# The dialog opens from Print Settins tab -> Bed Shape: Set...
+
 package Slic3r::GUI::BedShapeDialog;
 use strict;
 use warnings;

lib/Slic3r/GUI/BonjourBrowser.pm

@@ -1,3 +1,5 @@
+# A tiny dialog to select an OctoPrint device to print to.
+
 package Slic3r::GUI::BonjourBrowser;
 use strict;
 use warnings;

lib/Slic3r/GUI/ConfigWizard.pm

@@ -1,3 +1,6 @@
+# The config wizard is executed when the Slic3r is first started.
+# The wizard helps the user to specify the 3D printer properties.
+
 package Slic3r::GUI::ConfigWizard;
 use strict;
 use warnings;

lib/Slic3r/GUI/Controller.pm

@@ -1,3 +1,7 @@
+# The "Controller" tab to control the printer using serial / USB.
+# This feature is rarely used. Much more often, the firmware reads the G-codes from a SD card.
+# May there be multiple subtabs per each printer connected?
+
 package Slic3r::GUI::Controller;
 use strict;
 use warnings;

lib/Slic3r/GUI/Controller/ManualControlDialog.pm

@@ -1,3 +1,5 @@
+# A printer "Controller" -> "ManualControlDialog" subtab, opened per 3D printer connected?
+
 package Slic3r::GUI::Controller::ManualControlDialog;
 use strict;
 use warnings;

lib/Slic3r/GUI/MainFrame.pm

@@ -1,3 +1,5 @@
+# The main frame, the parent of all.
+
 package Slic3r::GUI::MainFrame;
 use strict;
 use warnings;

lib/Slic3r/GUI/Notifier.pm

@@ -1,3 +1,6 @@
+# Notify about the end of slicing.
+# The notifications are sent out using the Growl protocol if installed, and using DBus XWindow protocol.
+
 package Slic3r::GUI::Notifier;
 use Moo;
 

lib/Slic3r/GUI/OptionsGroup.pm

@@ -1,3 +1,5 @@
+# A dialog group object. Used by the Tab, SimpleTab, Preferences dialog, ManualControlDialog etc.
+
 package Slic3r::GUI::OptionsGroup;
 use Moo;
 

lib/Slic3r/GUI/Plater.pm

@@ -1,3 +1,5 @@
+# The "Plater" tab. It contains the "3D", "2D", "Preview" and "Layers" subtabs.
+
 package Slic3r::GUI::Plater;
 use strict;
 use warnings;

lib/Slic3r/GUI/Plater/2D.pm

@@ -1,3 +1,6 @@
+# 2D preview on the platter.
+# 3D objects are visualized by their convex hulls.
+
 package Slic3r::GUI::Plater::2D;
 use strict;
 use warnings;

lib/Slic3r/GUI/Plater/2DToolpaths.pm

@@ -1,5 +1,6 @@
 # 2D preview of the tool paths of a single layer, using a thin line.
 # OpenGL is used to render the paths.
+# Vojtech also added a 2D simulation of under/over extrusion in a single layer.
 
 package Slic3r::GUI::Plater::2DToolpaths;
 use strict;

lib/Slic3r/GUI/Plater/ObjectCutDialog.pm

@@ -1,3 +1,6 @@
+# Cut an object at a Z position, keep either the top or the bottom of the object.
+# This dialog gets opened with the "Cut..." button above the platter.
+
 package Slic3r::GUI::Plater::ObjectCutDialog;
 use strict;
 use warnings;

lib/Slic3r/GUI/Plater/ObjectPartsPanel.pm

@@ -1,3 +1,6 @@
+# Configuration of mesh modifiers and their parameters.
+# This panel is inserted into ObjectSettingsDialog.
+
 package Slic3r::GUI::Plater::ObjectPartsPanel;
 use strict;
 use warnings;

lib/Slic3r/GUI/Plater/ObjectSettingsDialog.pm

@@ -1,3 +1,7 @@
+# This dialog opens up when double clicked on an object line in the list at the right side of the platter.
+# One may load additional STLs and additional modifier STLs,
+# one may change the properties of the print per each modifier mesh or a Z-span.
+
 package Slic3r::GUI::Plater::ObjectSettingsDialog;
 use strict;
 use warnings;

lib/Slic3r/GUI/Plater/OverrideSettingsPanel.pm

@@ -1,3 +1,6 @@
+# Included in ObjectSettingsDialog -> ObjectPartsPanel.
+# Maintains, displays, adds and removes overrides of slicing parameters for an object and its modifier mesh.
+
 package Slic3r::GUI::Plater::OverrideSettingsPanel;
 use strict;
 use warnings;

lib/Slic3r/GUI/Preferences.pm

@@ -1,3 +1,5 @@
+# Preferences dialog, opens from Menu: File->Preferences
+
 package Slic3r::GUI::Preferences;
 use Wx qw(:dialog :id :misc :sizer :systemsettings wxTheApp);
 use Wx::Event qw(EVT_BUTTON EVT_TEXT_ENTER);

lib/Slic3r/GUI/ProgressStatusBar.pm

@@ -1,3 +1,5 @@
+# Status bar at the bottom of the main screen.
+
 package Slic3r::GUI::ProgressStatusBar;
 use strict;
 use warnings;

lib/Slic3r/GUI/Projector.pm

@@ -1,3 +1,5 @@
+# DLP Projector screen for the SLA (stereolitography) print process
+
 package Slic3r::GUI::Projector;
 use strict;
 use warnings;

lib/Slic3r/GUI/SimpleTab.pm

@@ -1,3 +1,6 @@
+# The "Simple" Print Settings tab.
+# The "Simple" mode is enabled by File->Preferences dialog.
+
 package Slic3r::GUI::SimpleTab;
 use strict;
 use warnings;

lib/Slic3r/GUI/Tab.pm

@@ -1,3 +1,6 @@
+# The "Expert" tab at the right of the main tabbed window.
+# The "Expert" is enabled by File->Preferences dialog.
+
 package Slic3r::GUI::Tab;
 use strict;
 use warnings;

lib/Slic3r/Test/SectionCut.pm

@@ -1,4 +1,6 @@
-# Slices at the XZ plane, for debugging purposes.
+# 2D cut in the XZ plane through the toolpaths.
+# For debugging purposes.
+
 package Slic3r::Test::SectionCut;
 use Moo;