tools: fix typos, grammar, punctuation

Author: ThomasWaldmann

tools/decode_s2.py

@@ -112,8 +112,8 @@
 
 def twos_comp(val, bits):
     """
-    compute the correct value of a 2's complement
-    based on the number of bits in the source
+    Compute the correct two's complement value
+    based on the number of bits in the source.
     """
     if (val & (1 << (bits - 1))) != 0:  # if sign bit is set e.g., 8bit: 128-255
         val = val - (1 << bits)         # compute negative value

tools/disassemble.py

@@ -10,8 +10,8 @@
 import sys
 
 
-# placeholders:
-# these functions will be dynamically loaded later based on the chosen cpu
+# Placeholders:
+# These functions will be dynamically loaded later based on the chosen CPU
 decode_instruction, get_instruction_fields = None, None
 
 
@@ -21,7 +21,7 @@ def load_decoder(cpu):
     elif cpu == 'esp32s2':
         mod = 'decode_s2'
     else:
-        raise ValueError('Invalid cpu')
+        raise ValueError('Invalid CPU')
 
     relative_import = 1 if '/' in __file__ else 0
     decode = __import__(mod, globals(), locals(), [], relative_import)

tools/genpkgjson.py

@@ -8,12 +8,12 @@
 """
 Tool for generating package.json for the MIP package manager
 
-Run this tool from the repo root, like:
+Run this tool from the repo root like this:
 
 python tools/genpkgjson.py > package.json
 
 Note:
-This tool works with both python3 and micropyton.
+This tool works with both Python 3 and MicroPython.
 """
 
 import os
@@ -38,9 +38,9 @@ def print_package_json(urls):
     """
     Custom-formatting JSON output for better readability
 
-    json.dumps in MicroPython cannot format the output and python3
-    puts each element of each urls' sub-arrays onto a new line.
-    Here we print each file and its source url onto the same line.
+    json.dumps in MicroPython cannot format the output, and Python 3
+    puts each element of each URLs subarray on a new line.
+    Here we print each file and its source URL on the same line.
     """
     print('{')
     print(f'  "v":{PACKAGE_JSON_VERSION},')