Skip to content

Tips

Jump to bottom
shyun3 edited this page Aug 6, 2026 · 21 revisions

ClangFormat

C headers

Attempting to format a C header (extension .h) may result in an error such as Formatter 'clang-format' error: Configuration file(s) do(es) not support C++ if the Language option was set to C. This is likely because clang-format detects C headers as C++ files.

A simple way to force the header to be detected as C is to use a special comment before the first non-comment line (as noted in the documentation for the Language option):

// clang-format Language: C

dotdrop

To ensure install actions are run (such as installation of binaries) even if no dotfile would be installed (due to lack of modifications), add the --force-actions flag e.g.

dotdrop -p windows -a

SSH

The ssh-agent Oh My Zsh plugin is being used to manage credentials. Simply update the identities style with the desired keys, for example:

zstyle :omz:plugins:ssh-agent identities id_ed25519 id_ed25519_work

This can be specified in ~/.zshenv to keep it machine specific. Note that this is only needed if multiple identities are being used.

Make sure to add non-default identities to the SSH config, see example. To use the identity with Git, specify the desired host. For example:

git clone git@github-work:user/repo.git

Typer

Homepage

A short option name for help can be added as follows:

app = typer.Typer(context_settings={"help_option_names": ["-h", "--help"]})

See also #201.

Windows Terminal

  • To regenerate dynamic profiles that have been deleted, remove $Env:LocalAppData\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\state.json

WSL

  • If Windows applications cannot be called from WSL, try entering the following: 
    sudo systemctl mask systemd-binfmt.service
    Taken from this comment. More details can be found in issue #8843.

Prolific PL2303 serial port support

By default, the WSL 2 kernel does not enable the driver for the PL2303 USB to serial converter. A new kernel will have to be built with that support. See this issue for more details.

Zsh

  • Place machine-specific settings in ~/.zshenv, e.g. $path=(/path/to/dir $path)
  • To check the completion handler for a command, examine $_comps e.g. echo $_comps[fd]

Clone this wiki locally