Improved M915 description

7 years ago · 5c076a6d93
37 changed files with 333 additions and 259 deletions
--- a/Marlin/Configuration_adv.h
+++ b/Marlin/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/default/Configuration_adv.h
+++ b/Marlin/src/config/default/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/AlephObjects/TAZ4/Configuration_adv.h
+++ b/Marlin/src/config/examples/AlephObjects/TAZ4/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Anet/A6/Configuration_adv.h
+++ b/Marlin/src/config/examples/Anet/A6/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Anet/A8/Configuration_adv.h
+++ b/Marlin/src/config/examples/Anet/A8/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Azteeg/X5GT/Configuration_adv.h
+++ b/Marlin/src/config/examples/Azteeg/X5GT/Configuration_adv.h
@ -1149,13 +1149,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/BQ/Hephestos/Configuration_adv.h
+++ b/Marlin/src/config/examples/BQ/Hephestos/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/BQ/Hephestos_2/Configuration_adv.h
+++ b/Marlin/src/config/examples/BQ/Hephestos_2/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/BQ/WITBOX/Configuration_adv.h
+++ b/Marlin/src/config/examples/BQ/WITBOX/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Cartesio/Configuration_adv.h
+++ b/Marlin/src/config/examples/Cartesio/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Creality/CR-10/Configuration_adv.h
+++ b/Marlin/src/config/examples/Creality/CR-10/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Felix/Configuration_adv.h
+++ b/Marlin/src/config/examples/Felix/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/FolgerTech/i3-2020/Configuration_adv.h
+++ b/Marlin/src/config/examples/FolgerTech/i3-2020/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Infitary/i3-M508/Configuration_adv.h
+++ b/Marlin/src/config/examples/Infitary/i3-M508/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/MakerParts/Configuration_adv.h
+++ b/Marlin/src/config/examples/MakerParts/Configuration_adv.h
@ -1149,13 +1149,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Malyan/M150/Configuration_adv.h
+++ b/Marlin/src/config/examples/Malyan/M150/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Malyan/M200/Configuration_adv.h
+++ b/Marlin/src/config/examples/Malyan/M200/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Micromake/C1/enhanced/Configuration_adv.h
+++ b/Marlin/src/config/examples/Micromake/C1/enhanced/Configuration_adv.h
@ -1149,13 +1149,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Mks/Sbase/Configuration_adv.h
+++ b/Marlin/src/config/examples/Mks/Sbase/Configuration_adv.h
@ -1156,13 +1156,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/RigidBot/Configuration_adv.h
+++ b/Marlin/src/config/examples/RigidBot/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/SCARA/Configuration_adv.h
+++ b/Marlin/src/config/examples/SCARA/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Sanguinololu/Configuration_adv.h
+++ b/Marlin/src/config/examples/Sanguinololu/Configuration_adv.h
@ -1137,13 +1137,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/TinyBoy2/Configuration_adv.h
+++ b/Marlin/src/config/examples/TinyBoy2/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/UltiMachine/Archim2/Configuration_adv.h
+++ b/Marlin/src/config/examples/UltiMachine/Archim2/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Velleman/K8200/Configuration_adv.h
+++ b/Marlin/src/config/examples/Velleman/K8200/Configuration_adv.h
@ -1159,13 +1159,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Velleman/K8400/Configuration_adv.h
+++ b/Marlin/src/config/examples/Velleman/K8400/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/Wanhao/Duplicator
+++ b/Marlin/src/config/examples/Wanhao/Duplicator
@ -1150,13 +1150,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/delta/FLSUN/auto_calibrate/Configuration_adv.h
+++ b/Marlin/src/config/examples/delta/FLSUN/auto_calibrate/Configuration_adv.h
@ -1150,13 +1150,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/delta/FLSUN/kossel_mini/Configuration_adv.h
+++ b/Marlin/src/config/examples/delta/FLSUN/kossel_mini/Configuration_adv.h
@ -1150,13 +1150,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/delta/generic/Configuration_adv.h
+++ b/Marlin/src/config/examples/delta/generic/Configuration_adv.h
@ -1150,13 +1150,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/delta/kossel_mini/Configuration_adv.h
+++ b/Marlin/src/config/examples/delta/kossel_mini/Configuration_adv.h
@ -1150,13 +1150,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/delta/kossel_pro/Configuration_adv.h
+++ b/Marlin/src/config/examples/delta/kossel_pro/Configuration_adv.h
@ -1155,13 +1155,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/delta/kossel_xl/Configuration_adv.h
+++ b/Marlin/src/config/examples/delta/kossel_xl/Configuration_adv.h
@ -1150,13 +1150,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/gCreate/gMax1.5+/Configuration_adv.h
+++ b/Marlin/src/config/examples/gCreate/gMax1.5+/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/makibox/Configuration_adv.h
+++ b/Marlin/src/config/examples/makibox/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/tvrrug/Round2/Configuration_adv.h
+++ b/Marlin/src/config/examples/tvrrug/Round2/Configuration_adv.h
@ -1148,13 +1148,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)
--- a/Marlin/src/config/examples/wt150/Configuration_adv.h
+++ b/Marlin/src/config/examples/wt150/Configuration_adv.h
@ -1149,13 +1149,15 @@
   */
  //#define TMC_DEBUG

-  /*
-   * Enable M915 Z axis calibration.
-   * Marlin will first adjust Z stepper current and then drive
-   * the Z axis to its' physical maximum. Finally it will home
-   * the Z axis to account for the lost steps. Use
-   * M915 S### to specify the current and
-   * M925 Z## to specify the extra Z height that's added to Z_MAX_POS.
+  /**
+   * M915 Z Axis Calibration
+   *
+   * - Adjust Z stepper current,
+   * - Drive the Z axis to its physical maximum, and
+   * - Home Z to account for the lost steps.
+   *
+   * Use M915 Snn to specify the current.
+   * Use M925 Znn to add extra Z height to Z_MAX_POS.
   */
  //#define TMC_Z_CALIBRATION
  #if ENABLED(TMC_Z_CALIBRATION)