I thought that I had a working `\refdir` command for doxygen that would generate correct links to directory documentation, even in out-of-tree builds. Unfortunately, it only worked for out-of-tree builds whose `@srcdir@` did not contain the string `../`.