Refs #7931. Clean up and documenting code.

Code/Mantid/Vates/VatesSimpleGui/ViewWidgets/inc/MantidVatesSimpleGuiViewWidgets/StandardView.h

@@ -68,6 +68,7 @@ class EXPORT_OPT_MANTIDVATES_SIMPLEGUI_VIEWWIDGETS StandardView : public ViewBas
   void resetDisplay();
   /// @see ViewBase::updateUI()
   void updateUI();
+  /// @see ViewBase::updateView()
   void updateView();
 
 protected slots:
@@ -77,6 +78,7 @@ protected slots:
   void onDestroyingSource(pqPipelineSource *src);
   /// Invoke the RebinnerCutter on the current dataset.
   void onRebinButtonClicked();
+  /// Perform operations when rendering is done.
   void onRenderDone();
   /// Invoke the ScaleWorkspace on the current dataset.
   void onScaleButtonClicked();

Code/Mantid/Vates/VatesSimpleGui/ViewWidgets/inc/MantidVatesSimpleGuiViewWidgets/ViewBase.h

@@ -138,6 +138,7 @@ public slots:
   void setTimeSteps(bool withUpdate = false);
   /// Provide updates to UI.
   virtual void updateUI();
+  /// Provide updates to View
   virtual void updateView();
 
 signals:

Code/Mantid/Vates/VatesSimpleGui/ViewWidgets/src/MdViewerWidget.cpp

@@ -507,7 +507,6 @@ void MdViewerWidget::checkForUpdates()
     this->currentView->setAxisScales();
     pqActiveObjects::instance().setActiveSource(src);
     this->currentView->setTimeSteps(true);
-    //this->currentView->resetCamera();
     this->currentView->updateView();
     this->currentView->updateUI();
   }

Code/Mantid/Vates/VatesSimpleGui/ViewWidgets/src/StandardView.cpp

@@ -154,6 +154,10 @@ void StandardView::onScaleButtonClicked()
                                        this->getPvActiveSrc());
 }
 
+/**
+ * This function is responsible for calling resetCamera if the internal
+ * variable cameraReset has been set to true.
+ */
 void StandardView::onRenderDone()
 {
   if (this->cameraReset)

Code/Mantid/Vates/VatesSimpleGui/ViewWidgets/src/ViewBase.cpp

@@ -614,6 +614,9 @@ void ViewBase::updateUI()
 {
 }
 
+/**
+ * This function is where one specifies updates to the held view.
+ */
 void ViewBase::updateView()
 {
 }