Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-8709

RES_FILE and RC_FILE are documented in a misleading way

    XMLWordPrintable

Details

    • 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.

      Attachments

        For Gerrit Dashboard: QTBUG-8709
        # Subject Branch Project Status CR V

        Activity

          People

            jbornema Joerg Bornemann
            sgdoerfler Steven Doerfler
            Votes:
            1 Vote for this issue
            Watchers:
            6 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes