naiveproxy/build/toolchain/win/rc/README.md
2018-02-02 05:49:39 -05:00

31 lines
1.3 KiB
Markdown

# rc
This contains a cross-platform reimplementation of rc.exe.
This exists mainly to compile .rc files on non-Windows hosts for cross builds.
However, it also runs on Windows for two reasons:
1. To compare the output of Microsoft's rc.exe and the reimplementation and to
check that they produce bitwise identical output.
2. The reimplementation supports printing resource files in /showIncludes
output, which helps getting build dependencies right.
The resource compiler consists of two parts:
1. A python script rc.py that serves as the driver. It does unicode
conversions, runs the input through the preprocessor, and then calls the
actual resource compiler.
2. The resource compiler, a C++ binary obtained via sha1 files from Google
Storage. The binary's code currenty lives at
https://github.com/nico/hack/tree/master/res, even though work is (slowly)
underway to upstream it into LLVM.
To update the rc binary, run `upload_rc_binaries.sh` in this directory, on a
Mac.
rc isn't built from source as part of the regular chrome build because
it's needed in a gn toolchain tool, and these currently cannot have deps.
Alternatively, gn could be taught about deps on tools, or rc invocations could
be not a tool but a template like e.g. yasm invocations (which can have deps),
then the prebuilt binaries wouldn't be needed.