Tips

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 linux -a

eget

To upgrade a GitHub binary, enter the dotfiles root directory and run the following:

EGET_CONFIG=scripts/eget.toml eget <author/repo>

The config should already specify upgrade_only. The proper target directory is set as well.

WSL

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.