From 386a150b920849cb9aa555ff5af53be8e4aabc73 Mon Sep 17 00:00:00 2001
From: EvilGremlin <22657714+EvilGremlin@users.noreply.github.com>
Date: Thu, 9 Feb 2023 06:46:02 +0300
Subject: [PATCH] =?UTF-8?q?=F0=9F=94=A8=20Adjust=20INI=20comments=20(#2518?=
 =?UTF-8?q?3)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ini/renamed.ini       | 33 +++++++++++----------------------
 ini/stm32f1-maple.ini |  2 +-
 ini/stm32f1.ini       | 15 ++++++++++++++-
 ini/stm32g0.ini       |  3 +++
 4 files changed, 29 insertions(+), 24 deletions(-)

diff --git a/ini/renamed.ini b/ini/renamed.ini
index fa154f3a0f041..cd890b593cb50 100644
--- a/ini/renamed.ini
+++ b/ini/renamed.ini
@@ -21,46 +21,35 @@ board     = genericSTM32F103RE
 # List of environment names that are no longer used
 #
 
-[env:STM32F103RET6_creality_maple]
-# Renamed to STM32F103RE_creality_maple
+[env:STM32F103RET6_creality_maple]    ;=> STM32F103RE_creality_maple
 extends = renamed
 
-[env:STM32F103RET6_creality]
-# Renamed to STM32F103RE_creality
+[env:STM32F103RET6_creality]          ;=> STM32F103RE_creality
 extends = renamed
 
-[env:STM32F103RET6_creality_xfer]
-# Renamed to STM32F103RE_creality_xfer
+[env:STM32F103RET6_creality_xfer]     ;=> STM32F103RE_creality_xfer
 extends = renamed
 
-[env:STM32F103RC_btt_512K]
-# Renamed to STM32F103RE_btt
+[env:STM32F103RC_btt_512K]            ;=> STM32F103RE_btt
 extends = renamed
 
-[env:STM32F103RC_btt_512K_USB]
-# Renamed to STM32F103RE_btt_USB
+[env:STM32F103RC_btt_512K_USB]        ;=> STM32F103RE_btt_USB
 extends = renamed
 
-[env:STM32F103RC_btt_512K_maple]
-# Renamed to STM32F103RE_btt_maple
+[env:STM32F103RC_btt_512K_maple]      ;=> STM32F103RE_btt_maple
 extends = renamed
 
-[env:STM32F103RC_btt_512K_USB_maple]
-# Renamed to STM32F103RE_btt_USB_maple
+[env:STM32F103RC_btt_512K_USB_maple]  ;=> STM32F103RE_btt_USB_maple
 extends = renamed
 
-[env:STM32F103RC_meeb]
-# Renamed to STM32F103RC_meeb_maple
+[env:STM32F103RC_meeb]                ;=> STM32F103RC_meeb_maple
 extends = renamed
 
-[env:STM32F103VE_GTM32]
-# Renamed to STM32F103VE_GTM32_maple
+[env:STM32F103VE_GTM32]               ;=> STM32F103VE_GTM32_maple
 extends = renamed
 
-[env:mks_robin_nano35]
-# Renamed to mks_robin_nano_v1v2
+[env:mks_robin_nano35]                ;=> mks_robin_nano_v1v2
 extends = renamed
 
-[env:mks_robin_nano35_maple]
-# Renamed to mks_robin_nano_v1v2_maple
+[env:mks_robin_nano35_maple]          ;=> mks_robin_nano_v1v2_maple
 extends = renamed
diff --git a/ini/stm32f1-maple.ini b/ini/stm32f1-maple.ini
index 2e3cd0a37a251..dc75774754314 100644
--- a/ini/stm32f1-maple.ini
+++ b/ini/stm32f1-maple.ini
@@ -137,7 +137,7 @@ debug_tool           = jlink
 upload_protocol      = jlink
 
 #
-# Creality (STM32F103RET6)
+# Creality 512K (STM32F103RE) for new 64KiB bootloader (CR-10 Smart Pro printer)
 #
 [env:STM32F103RE_creality_smartPro_maple]
 extends              = env:STM32F103RE_creality_maple
diff --git a/ini/stm32f1.ini b/ini/stm32f1.ini
index d8db3628c3077..1adc83a8f9993 100644
--- a/ini/stm32f1.ini
+++ b/ini/stm32f1.ini
@@ -135,7 +135,11 @@ debug_tool                  = jlink
 upload_protocol             = jlink
 
 #
-# Custom upload to SD via Marlin with Binary Protocol
+# Creality (STM32F103Rx)
+# With custom upload to SD via Marlin with binary protocol.
+# Requires Marlin with BINARY_FILE_TRANSFER already installed on the target board.
+# If CUSTOM_FIRMWARE_UPLOAD is also installed, Marlin will reboot the board to install the firmware.
+# Currently CUSTOM_FIRMWARE_UPLOAD must also be enabled to use 'xfer' build envs.
 #
 [STM32F103Rx_creality_xfer]
 extends         = STM32F103Rx_creality
@@ -151,10 +155,16 @@ upload_protocol = custom
 extends = STM32F103Rx_creality
 board   = genericSTM32F103RE
 
+#
+# Creality 512K (STM32F103RE) with custom binary upload to SD (see above).
+#
 [env:STM32F103RE_creality_xfer]
 extends = STM32F103Rx_creality_xfer
 board   = genericSTM32F103RE
 
+#
+# Creality 512K (STM32F103RE) for new 64KiB bootloader (CR-10 Smart Pro printer)
+#
 [env:STM32F103RE_creality_smartPro]
 extends                     = STM32F103Rx_creality
 board_build.offset          = 0x10000
@@ -167,6 +177,9 @@ board_upload.offset_address = 0x08010000
 extends = STM32F103Rx_creality
 board   = genericSTM32F103RC
 
+#
+# Creality 256K (STM32F103RC) with custom binary upload to SD (see above).
+#
 [env:STM32F103RC_creality_xfer]
 extends = STM32F103Rx_creality_xfer
 board   = genericSTM32F103RC
diff --git a/ini/stm32g0.ini b/ini/stm32g0.ini
index c8554741bceb0..5891395642dc0 100644
--- a/ini/stm32g0.ini
+++ b/ini/stm32g0.ini
@@ -61,6 +61,9 @@ debug_tool                  = stlink
 #
 # BigTreeTech SKR Mini E3 V3.0 / Manta E3 EZ V1.0 / Manta M4P V1.0 / Manta M5P V1.0 (STM32G0B1RET6 ARM Cortex-M0+)
 # Custom upload to SD via Marlin with Binary Protocol
+# Requires Marlin with BINARY_FILE_TRANSFER already installed on the target board.
+# If CUSTOM_FIRMWARE_UPLOAD is also installed, Marlin will reboot the board to install the firmware.
+# Currently CUSTOM_FIRMWARE_UPLOAD must also be enabled to use 'xfer' build envs.
 #
 [env:STM32G0B1RE_btt_xfer]
 extends         = env:STM32G0B1RE_btt