config: Update wording of extruder parameters in example.cfg

Try to improve the description of the extruder config limits.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>

1 files changed, 17 insertions, 18 deletions

diff --git a/config/example.cfg b/config/example.cfg
index 344c525d..a086977c 100644
--- a/config/example.cfg
+++ b/config/example.cfg
@@ -100,29 +100,28 @@ nozzle_diameter: 0.500
 #   Diameter of the nozzle orifice (in mm). This parameter must be
 #   provided.
 filament_diameter: 3.500
-#   Diameter of the raw filament (in mm) as it enters the
+#   The nominal diameter of the raw filament (in mm) as it enters the
 #   extruder. This parameter must be provided.
 #max_extrude_cross_section:
-#   Maximum area of the cross section of an extrusion line (in
-#   mm^2). This setting prevents excessive amounts of extrusion during
-#   relatively small XY moves. If a move requests an extrusion rate
-#   that would exceed this value it will cause an error to be
-#   returned. The default is: 4.0 * nozzle_diameter^2
+#   Maximum area (in mm^2) of an extrusion cross section (eg,
+#   extrusion width multiplied by layer height). This setting prevents
+#   excessive amounts of extrusion during relatively small XY moves.
+#   If a move requests an extrusion rate that would exceed this value
+#   it will cause an error to be returned. The default is: 4.0 *
+#   nozzle_diameter^2
 #max_extrude_only_distance: 50.0
-#   Maximum length (in mm of raw filament) that an extrude only move
-#   may be. If an extrude only move requests a distance greater than
-#   this value it will cause an error to be returned. The default is
-#   50mm.
+#   Maximum length (in mm of raw filament) that a retraction or
+#   extrude-only move may have. If a retraction or extrude-only move
+#   requests a distance greater than this value it will cause an error
+#   to be returned. The default is 50mm.
 #max_extrude_only_velocity:
-#   Maximum velocity (in mm/s) of the extruder motor for extrude only
-#   moves. If this is not specified then it is calculated to match the
-#   limit an XY printing move with a max_extrude_cross_section
-#   extrusion would have.
 #max_extrude_only_accel:
-#   Maximum acceleration (in mm/s^2) of the extruder motor for extrude
-#   only moves. If this is not specified then it is calculated to
-#   match the limit an XY printing move with a
-#   max_extrude_cross_section extrusion would have.
+#   Maximum velocity (in mm/s) and acceleration (in mm/s^2) of the
+#   extruder motor for retractions and extrude-only moves. These
+#   settings do not place any limit on normal printing moves. If not
+#   specified then they are calculated to match the limit an XY
+#   printing move with a max_extrude_cross_section extrusion would
+#   have.
 #pressure_advance: 0.0
 #   The amount of raw filament to push into the extruder during
 #   extruder acceleration. An equal amount of filament is retracted