summaryrefslogtreecommitdiff
path: root/scripts
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-04-26 20:51:03 -0500
committerCraig Jennings <c@cjennings.net>2026-04-26 20:51:03 -0500
commite1127b148033d44b5606dcd7a7b9d7a567b92b95 (patch)
tree0cc342a0f005da6001b9026e976599a1eedcf110 /scripts
parentc0cb564253ac507d6930171b18df276debb44df6 (diff)
downloaddotemacs-e1127b148033d44b5606dcd7a7b9d7a567b92b95.tar.gz
dotemacs-e1127b148033d44b5606dcd7a7b9d7a567b92b95.zip
docs(design): add debug-profiling.el module brainstorm output
Captures the agreed v1 shape for a new =debug-profiling.el= module: targeted slow-command investigation, two features ("profile next command" and "time region or sexp"), each split into pure helper plus interactive wrapper. Migrates the existing =profiler-*= bindings and =cj/benchmark-this-method= out of =config-utilities.el=. Stays on the existing =C-c d= debug umbrella prefix. Six approaches were considered: three conventional, plus three tail samples (macro-first, log-and-grep, treesit picker). Recommendation is the boring named-operation surface backed by a thin wrapper over the built-in =profiler.el= and =benchmark.el=. The other five options are recorded with reasons-rejected so a future reader can see what was weighed. Design covers architecture, data flow, error handling, testing approach, and observability. Two open questions are parked: default REPS for =cj/time--expr=, and whether to capture =cpu+mem= or just =cpu=. Both are fine to defer until v1 has been used on the queued org-capture target-building investigation. Implementation will run via =/start-work= against this design.
Diffstat (limited to 'scripts')
0 files changed, 0 insertions, 0 deletions