ECMWinResolveSymlinks — Extra CMake Modules 5.115.0 documentation

# ECMWinResolveSymlinks

Resolve pseudo-symlinks created by git when cloning on Windows.

    ecm_win_resolve_symlinks(<dir>)

When git checks out a repository with UNIX symlinks on Windows machine, it creates a text file for each symlink, containing a relative path to the real file. This function would recursively walk over specified directory and replace pseudo-symlinks with corresponding real file’s contents. It would then run `git update-index --assume-unchanged` on them to trick git.

This is useful for projects like “breeze-icons” that contain many identical icons implemented as symlinks.

Since 5.28