zimfw/modules/debug/Readme.md

Debug
=====

Provides a function to debug Zim.

Functions
---------

  - `trace-zim` provides a trace of Zsh/Zim startup

Notes
-----

The `trace-zim` command will not alter your current dotfiles.
It will copy your environment to a temporary directory, launch zsh
within that environment, and output logs.

This will provide a ztrace.tar.gz archive, which should be attached
to any bug reports if you need help with an issue that you don't understand.
add debug module 2015-12-27 19:08:43 -05:00			`Debug`
			`=====`

			`Provides a function to debug Zim.`

			`Functions`
			`---------`

			- `trace-zim` provides a trace of Zsh/Zim startup

			`Notes`
			`-----`

			The `trace-zim` command will not alter your current dotfiles.
[debug] Refactor debug module Use `$PS4` debugging prompt to generate timestamps, instead of GNU `date`. This also keeps timestamps and respective command together, something that `paste` could not guarantee given some commands may have multiple lines. The prompt timestamp has a precision of 6 decimals. The `printf "%12.9f\n"` instruction with 9 decimals was kept to keep producing "the SAME output". This could be replaced to `printf "%12.6f\n"` to make the output smaller. Also, only the first line of commands with multiple lines are saved, to keep the output format backwards-compatible. Closes #84 2016-09-27 10:45:47 -04:00			`It will copy your environment to a temporary directory, launch zsh`
			`within that environment, and output logs.`
add debug module 2015-12-27 19:08:43 -05:00
			`This will provide a ztrace.tar.gz archive, which should be attached`
			`to any bug reports if you need help with an issue that you don't understand.`