Correct timestamp on CommonHFile.h

More improvements to printing
Updated docs.

Author: mhightower83

doc/faq/a06-global-build-options.rst

@@ -123,6 +123,16 @@ a hidden directory. For help with this do an Internet search on
 ``windows disk cleanup``. Or, type ``disk cleanup`` in the Windows®
 taskbar search box.
 
+You can run multiple Arduino IDE windows as long as you run one version
+of the Arduino IDE at a time. When testing different versions,
+completely exit one before starting the next version. For example,
+Arduino IDE 1.8.19 and Arduino IDE 2.0 work with different temp and
+build paths. With this combination, the workaround logic sometimes fails
+to enable. At the time of this writing, when Arduino IDE 2.0 rc5 exits,
+it leaves the temp space dirty. This keeps the workaround active the
+next time the IDE is started. If this is an issue, manually delete the
+temp files.
+
 If you think your workflow performance would benefit from keeping a per
 Sketch copy of ``core.a``, you can turn off the “Aggressively cache
 compiled core” feature. You need to find the location of

tools/mkbuildoptglobals.py

@@ -212,8 +212,16 @@
 
 def print_msg(*args, **kwargs):
     global msg_print_buf
-    # At this time, we can only handle one args value.
+    if 'sep' in kwargs:
+        sep = kwargs['sep']
+    else:
+        sep = ' '
+
     msg_print_buf += args[0]
+    for arg in args[1:]:
+        msg_print_buf += sep
+        msg_print_buf += arg
+
     if 'end' in kwargs:
         msg_print_buf += kwargs['end']
     else:
@@ -225,8 +233,7 @@ def print_err(*args, **kwargs):
     global err_print_flag
     if (args[0])[0] != ' ':
         print_msg("")
-    print_msg("*** ", end='')
-    print_msg(*args, **kwargs)
+    print_msg("***", *args, **kwargs)
     err_print_flag = True
 
 
@@ -311,9 +318,9 @@ def extract_create_build_opt_file(globals_h_fqfn, file_name, build_opt_fqfn):
             if line == build_opt_signature:
                 if complete_comment:
                     build_opt_error = True
-                    print_err("  Multiple embedded build.opt blocks in " + file_name + ":" + str(line_no))
+                    print_err("  Multiple embedded build.opt blocks in", f'{file_name}:{line_no}')
                     continue
-                print_msg("Extracting embedded compiler command-line options from " +  file_name + ":" + str(line_no))
+                print_msg("Extracting embedded compiler command-line options from", f'{file_name}:{line_no}')
                 for line in src:
                     line = line.strip()
                     line_no += 1
@@ -330,19 +337,19 @@ def extract_create_build_opt_file(globals_h_fqfn, file_name, build_opt_fqfn):
                         continue
                     # some consistency checking before writing - give some hints about what is wrong
                     elif line == build_opt_signature:
-                        print_err("  Double begin before end for embedded build.opt block in " + file_name + ":" + str(line_no))
+                        print_err("  Double begin before end for embedded build.opt block in", f'{file_name}:{line_no}')
                         build_opt_error = True
                     elif line.startswith(build_opt_signature):
-                        print_err("  build.opt signature block ignored, trailing character for embedded build.opt block in " + file_name + ":" + str(line_no))
+                        print_err("  build.opt signature block ignored, trailing character for embedded build.opt block in", f'{file_name}:{line_no}')
                         build_opt_error = True
                     elif "/*" in line or "*/" in line :
-                        print_err("  Nesting issue for embedded build.opt block in " + file_name + ":" + str(line_no))
+                        print_err("  Nesting issue for embedded build.opt block in", f'{file_name}:{line_no}')
                         build_opt_error = True
                     else:
-                        print_msg("  Add command-line option: " + line)
+                        print_msg("  ", f'{line_no:2}, Add command-line option: {line}', sep='')
                         build_opt.write(line + "\n")
             elif line.startswith(build_opt_signature):
-                print_err("  build.opt signature block ignored, trailing character for embedded build.opt block in " + file_name + ":" + str(line_no))
+                print_err("  build.opt signature block ignored, trailing character for embedded build.opt block in", f'{file_name}:{line_no}')
                 build_opt_error = True
     if not complete_comment or build_opt_error:
         build_opt.truncate(0)
@@ -507,6 +514,10 @@ def main():
         not os.path.exists(commonhfile_fqfn):
             enable_override(False, commonhfile_fqfn)
 
+        if time.time_ns() < os.stat(commonhfile_fqfn).st_mtime_ns:
+            print_err(f"Neutralize future timestamp on build file: {commonhfile_fqfn}")
+            touch(commonhfile_fqfn)
+
         if not os.path.exists(build_path_core):
             os.makedirs(build_path_core)
             print_msg("Clean build, created dir " + build_path_core)