Details
-
Bug
-
Resolution: Done
-
P2: Important
-
5.5.0
-
None
-
e66f247ccf345f1d303a92e53c21bb53d96c5af2 (qt/qtbase/5.13)
Description
http://doc.trolltech.com/4.6/qmake-project-files.html describes the RESOURCES variable as "A list of resource (.rc) files to be included in the final project." But the normal extension for these files is .qrc, not .rc. Since .rc is the normal extension for Windows-native resource files, and qmake also supports those (through an RC_FILE variable), this error could further confuse people. The description of RESOURCES should be change to refer to .qrc not .rc.
Also, the descriptions of RC_FILE and RES_FILE variables should be rewritten so they're not identical, since the two serve different purposes. The former holds the name of a Windows-native human-readable .rc file (or, on other platforms, the name of an icon file, I think). The RES_FILE variable holds the name of the binary .res file built from a .rc file by the Windows resource compiler rc.exe or equivalent.
Some text for these explaining that qmake works with two completely different resource systems, the Qt one and the Windows one, and clearly stating which variables and file extensions go with which, would likely help Qt users too.