added comments

platformio.ini

@@ -287,6 +287,7 @@ build_flags =
   -DEMSESP_DEFAULT_LOCALE=\"en\" -DEMSESP_DEFAULT_TX_MODE=8 -DEMSESP_DEFAULT_VERSION=\"3.8.0-dev.0\" -DEMSESP_DEFAULT_BOARD_PROFILE=\"S32\"
 
 ; Modbus
+;  Creates the file modbus_entity_parameters.hpp
 ;  Creating the modbus registers is a multi-step process. Before it was in a shell script called generate_csv_and_headers.sh
 ;  but now moved to pio so everything is in python and cross-platform. The logic is as follows:
 ;  1. create a dummy modbus_entity_parameters.hpp file so the first pass compiles
@@ -295,15 +296,9 @@ build_flags =
 ;  4. use the dump_entities.csv file with update_modbus_registers.py script to generate the modbus_entity_parameters.hpp file
 ;  5. clean up everything and start again with the EMSESP_STANDALONE flag set
 ;  6. run the entity_dump test command again to create the real dump_entities.csv file
-;  7. create the Modbus-Entity-Registers.md file
-;  8. create the dump_telegrams.csv file
 ;
-;  To run this in pio use the steps
+;  To use, run:
 ;   pio run -e build_modbus -t clean -t build
-;   pio run -e build_standalone -t clean -t build
-
-# builds the modbus_entity_parameters.hpp header file
-# pio run -e build_modbus -t clean -t build
 [env:build_modbus]
 extends = env:native
 targets = build
@@ -315,8 +310,11 @@ custom_test_command = entity_dump
 custom_output_file = dump_entities.csv
 custom_post_script = scripts/build_modbus_entity_parameters_post.py
 
-; builds the real dump_entities.csv and dump_telegrams.csv files, and also the Modbus-Entity-Registers.md file
-; to be run after build_modbus with: pio run -e build_standalone -t clean -t build
+; builds the real dump_entities.csv and dump_telegrams.csv files
+; and also the Modbus-Entity-Registers.md file which is used in the emsesp.org documentation
+;
+; To use, run after build_modbus environment, with:
+; pio run -e build_standalone -t clean -t build
 [env:build_standalone]
 extends = env:native
 targets = build
@@ -326,4 +324,3 @@ build_flags = -DEMSESP_STANDALONE
 custom_test_command = entity_dump
 custom_output_file = dump_entities.csv
 custom_post_script = scripts/build_standalone_post.py
-