From 82a3ed2f9a76225ffadecd43c98cca1dc477673a Mon Sep 17 00:00:00 2001
From: Scott Lahteine <sourcetree@thinkyhead.com>
Date: Tue, 14 Jul 2015 19:49:43 -0700
Subject: [PATCH] Cleanup and dev notes in Marlin.h

---
 Marlin/Marlin.h | 54 +++++++++++++++++++++++--------------------------
 1 file changed, 25 insertions(+), 29 deletions(-)

diff --git a/Marlin/Marlin.h b/Marlin/Marlin.h
index 50ea9ecf07..bc237f049e 100644
--- a/Marlin/Marlin.h
+++ b/Marlin/Marlin.h
@@ -206,18 +206,6 @@ void disable_all_steppers();
 void FlushSerialRequestResend();
 void ok_to_send();
 
-#ifdef DELTA
-  void calculate_delta(float cartesian[3]);
-  #ifdef ENABLE_AUTO_BED_LEVELING
-    extern int delta_grid_spacing[2];
-    void adjust_delta(float cartesian[3]);
-  #endif
-  extern float delta[3];
-#endif
-#ifdef SCARA
-  void calculate_delta(float cartesian[3]);
-  void calculate_SCARA_forward_Transform(float f_scara[3]);
-#endif
 void reset_bed_level();
 void prepare_move();
 void kill(const char *);
@@ -269,26 +257,34 @@ extern int extruder_multiplier[EXTRUDERS]; // sets extrude multiply factor (in p
 extern float filament_size[EXTRUDERS]; // cross-sectional area of filament (in millimeters), typically around 1.75 or 2.85, 0 disables the volumetric calculations for the extruder.
 extern float volumetric_multiplier[EXTRUDERS]; // reciprocal of cross-sectional area of filament (in square millimeters), stored this way to reduce computational burden in planner
 extern float current_position[NUM_AXIS];
-extern float home_offset[3];
+extern float home_offset[3]; // axis[n].home_offset
+extern float min_pos[3]; // axis[n].min_pos
+extern float max_pos[3]; // axis[n].max_pos
+extern bool axis_known_position[3]; // axis[n].is_known
 
-#ifdef DELTA
-  extern float endstop_adj[3];
-  extern float delta_radius;
-  extern float delta_diagonal_rod;
-  extern float delta_segments_per_second;
-  void recalc_delta_settings(float radius, float diagonal_rod);
-#elif defined(Z_DUAL_ENDSTOPS)
+#if defined(DELTA) || defined(SCARA)
+  extern float delta[3];
+  void calculate_delta(float cartesian[3]);
+  #ifdef DELTA
+    extern float endstop_adj[3]; // axis[n].endstop_adj
+    extern float delta_radius;
+    extern float delta_diagonal_rod;
+    extern float delta_segments_per_second;
+    void recalc_delta_settings(float radius, float diagonal_rod);
+    #ifdef ENABLE_AUTO_BED_LEVELING
+      extern int delta_grid_spacing[2];
+      void adjust_delta(float cartesian[3]);
+    #endif
+  #elif defined(SCARA)
+    extern float axis_scaling[3];  // Build size scaling
+    void calculate_SCARA_forward_Transform(float f_scara[3]);
+  #endif
+#endif
+
+#ifdef Z_DUAL_ENDSTOPS
   extern float z_endstop_adj;
 #endif
 
-#ifdef SCARA
-  extern float axis_scaling[3];  // Build size scaling
-#endif
-
-extern float min_pos[3];
-extern float max_pos[3];
-extern bool axis_known_position[3];
-
 #ifdef ENABLE_AUTO_BED_LEVELING
   extern float zprobe_zoffset;
 #endif
@@ -320,7 +316,7 @@ extern int fanSpeed;
 
 #ifdef FWRETRACT
   extern bool autoretract_enabled;
-  extern bool retracted[EXTRUDERS];
+  extern bool retracted[EXTRUDERS]; // extruder[n].retracted
   extern float retract_length, retract_length_swap, retract_feedrate, retract_zlift;
   extern float retract_recover_length, retract_recover_length_swap, retract_recover_feedrate;
 #endif