docs: rewrite half-dash asides in comments

Dropping the double-dash asides left 72 comments and docstrings with
half a dash glued to the next word ("shape -a size or a size range -is
all"). They now read as a colon, a comma or parentheses, and a prose
style test names any that comes back.

scripts/scraper/targets/batocera_targets_scraper.py

@@ -132,7 +132,7 @@ def _check_atom(
     if tok.startswith('"'):
         pos += 1
         return True, pos
-    # Unknown token -treat as true to avoid false negatives
+    # Unknown token: treat as true to avoid false negatives
     pos += 1
     return True, pos