Introduce a --debug flag #265

pastor commented 2026年03月20日 19:31:37 +01:00

The debug flag should probably set the logging level to debug set the profile to debug (we probably need to decide what this means) and set the backtraces to show more stack frames.

We should also hide unnecessary stack frames on the backtraces. As we discussed this is quite verbose for the user. In my recent testings implementing the org stencil, the verbosity made it uncomfortable to navigate and find the information I was interested in. Of course Emacs is quite powerful and I can easily navigate long backtraces but I expect many terminal users to struggle with so much verbosity.

The debug flag should probably set the logging level to `debug` set the profile to `debug` (we probably need to decide what this means) and set the backtraces to show more stack frames. We should also hide unnecessary stack frames on the backtraces. As we discussed this is quite verbose for the user. In my recent testings implementing the [org stencil](https://codeberg.org/lapislazuli/blue/src/branch/user-manual/blue/stencils/org.scm), the verbosity made it uncomfortable to navigate and find the information I was interested in. Of course Emacs is quite powerful and I can easily navigate long backtraces but I expect many terminal users to struggle with so much verbosity.

pastor commented 2026年04月01日 18:28:19 +02:00

After discussion we've decided that it would be better to introduce the concept of log levels.

We've envisioned the following levels:

• user (default): print backtraces up to user code.
• blue: print backtraces up to BLUE code.
• pluggings: print backtraces up to plugging code.
• guile: print backtraces up to system libraries, eg: guile and guile libraries.

The flag will have the following aspect: --debug=blue.

Additionally, this can be controlled through a BLUE preference.

After discussion we've decided that it would be better to introduce the concept of log levels. We've envisioned the following levels: - user (default): print backtraces up to user code. - blue: print backtraces up to BLUE code. - pluggings: print backtraces up to plugging code. - guile: print backtraces up to system libraries, eg: guile and guile libraries. The flag will have the following aspect: `--debug=blue`. Additionally, this can be controlled through a BLUE preference.