chore: prune boilerplate and refresh stale docs

- Remove 257 redundant per-definition comment stubs across the package
- Drop dead nonlocal declarations in autoslicer_detection.py
- Document the swapped flag and swap_left_right in architecture docs
- Remove unsupported 'legacy override' claims from autotune/runtime docs

scanslicer/entry.py

@@ -3,7 +3,6 @@ import os
 import sys
 
 
-# parse_args: function definition for ScanSlicer behavior.
 def parse_args(argv=None):
     parser = argparse.ArgumentParser(
         prog="scanslicer",
@@ -23,7 +22,6 @@ def parse_args(argv=None):
     return parser.parse_args(argv)
 
 
-# _detect_backend_from_qpa_env: function definition for ScanSlicer behavior.
 def _detect_backend_from_qpa_env():
     qpa_value = os.environ.get("QT_QPA_PLATFORM", "").strip().lower()
     if not qpa_value:
@@ -38,7 +36,6 @@ def _detect_backend_from_qpa_env():
     return None
 
 
-# resolve_runtime_backend: function definition for ScanSlicer behavior.
 def resolve_runtime_backend(backend):
     if backend in ("wayland", "x11"):
         return backend
@@ -65,7 +62,6 @@ def resolve_runtime_backend(backend):
     return "wayland"
 
 
-# configure_qt_backend: function definition for ScanSlicer behavior.
 def configure_qt_backend(backend):
     if backend == "wayland":
         os.environ["QT_QPA_PLATFORM"] = "wayland"
@@ -99,7 +95,6 @@ def configure_qt_backend(backend):
         os.environ.setdefault("QT_QPA_PLATFORMTHEME", "gtk3")
 
 
-# validate_wayland_environment: function definition for ScanSlicer behavior.
 def validate_wayland_environment():
     runtime_dir = os.environ.get("XDG_RUNTIME_DIR", "").strip()
     display_name = os.environ.get("WAYLAND_DISPLAY", "").strip()
@@ -116,7 +111,6 @@ def validate_wayland_environment():
         )
 
 
-# validate_x11_environment: function definition for ScanSlicer behavior.
 def validate_x11_environment():
     display_name = os.environ.get("DISPLAY", "").strip()
     if not display_name:
@@ -125,7 +119,6 @@ def validate_x11_environment():
         )
 
 
-# main: function definition for ScanSlicer behavior.
 def main(argv=None):
     args = parse_args(sys.argv[1:] if argv is None else argv)
     runtime_backend = None