aboutsummaryrefslogtreecommitdiffstats
path: root/doc/qbs.qdoc
Commit message (Collapse)AuthorAgeFilesLines
...
* | Documentation: Add "How-to" pageChristian Kandeler2017-06-061-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | This fills a void in our documentation: Concrete, hands-on advice that is easily located. New items should be added based on feedback from our users. [ChangeLog] Added "How-to" section to documentation Change-Id: If959c9d979e18d44f6ef42810a8b0280bce64bda Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
* | Add documentation for generatorsJake Petroules2017-05-051-2/+77
|/ | | | | Change-Id: I49ef17ed4295bb93a870048a040bf71d6e93186f Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
* Allow running qbs without a profileChristian Kandeler2017-03-311-2/+2
| | | | | | | | | | | | | When no profile is given and no default one exists, simply use the modules' default values. The most relevant effect of this is that users can now build for the host platform by simply typing "qbs" without having done any manual setup, if there is a compiler in the PATH. [ChangeLog] It is no longer strictly required to provide a profile. Change-Id: Ifee09d2653dfbd4ea06c59248d78e376da2f217b Reviewed-by: Jake Petroules <jake.petroules@qt.io>
* Bump required Qt version to 5.6Christian Kandeler2017-02-271-1/+1
| | | | | | | | | | | It seems natural to use the LTS release as the minimum required version, and we get rid of a number of #ifdefs. [ChangeLog] Building qbs now requires Qt 5.6 Change-Id: I327ebb179a20e6372fa5ae765e0f3753fb9e9efa Reviewed-by: Jake Petroules <jake.petroules@qt.io> Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
* Assume UTF-8 encoding for qbs project filesChristian Kandeler2016-11-081-0/+1
| | | | | | | | Like QML has been doing forever. Task-number: QBS-941 Change-Id: I0e46003740b68f2172c623043a0861910c1fe29d Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
* Update license headersIikka Eklund2016-08-291-17/+14
| | | | | | | | | | Patch-set 3 includes rest of the files. Every source file needs to have up-to-date license headers in order to pass ci. Change-Id: I55ed96910b5cb13513f80eb118feafcdaa32e8b0 Reviewed-by: Jani Heikkinen <jani.heikkinen@qt.io>
* Merge 1.5 into 1.6Jake Petroules2016-06-281-2/+2
|\ | | | | | | Change-Id: If1a2c368170d89d5e6e11b08a32b37901d51eb1d
| * Do the OS X to macOS rename.v1.5.2Jake Petroules2016-06-271-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | [ChangeLog] The "osx" value in qbs.hostOS and qbs.targetOS has been replaced with "macos". For backwards compatibility, qbs.hostOS will still contain "osx" in addition to "macos", and an error will be printed if qbs.targetOS contains "osx" but not "macos". Specifying "macos" without "osx" is allowed. These checks are subject to be removed in a future version of qbs, so update your hostOS and targetOS checks accordingly. [ChangeLog] cpp.minimumOsxVersion has been deprecated and replaced with cpp.minimumMacosVersion. cpp.minimumOsxVersion is subject to be removed in a future version of qbs, so update your projects accordingly. Change-Id: I479891829dff6eb6750cb2a04e1395f085896f63 Reviewed-by: Jake Petroules <jake.petroules@qt.io>
* | Merge 1.5 into master.Christian Kandeler2016-06-271-0/+42
|\| | | | | | | Change-Id: I0d15404445ffbadfd5fb2277630650928bb24b05
| * Docs: List the supported property types.Christian Kandeler2016-06-241-0/+42
| | | | | | | | | | | | | | Task-number: QBS-983 Change-Id: Id0bd4a91f6afbe04621cfff28b0ef43dcfeee69b Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
* | Stop special casing qbs.buildVariant in command line handling.Jake Petroules2016-06-201-3/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This introduces qbs.configurationName, which takes the place of qbs.buildVariant in the command line and acts as a unique identifier for each build configuration, rather than relying on the combination of qbs.buildVariant and the profile name to do so. No longer special casing qbs.buildVariant allows the variant to be decoupled from the build configuration, and allow scenarios where a project may contain products hardcoded for particular build variants, and in future, special debug-and-release builds which create a single framework product containing multiple build variants. Incidentally, this change allows building multiple configurations of the same build variant and profile name combination, since the build configuration is no longer keyed on the aggregate of those values. Building for different profiles with the same configuration name in parallel is now no longer possible, but this is easily worked around by simply specifying different configuration names for such combinations. For example, the following is now possible: qbs \ static profile:a qbs.buildVariant:release project.useStaticLibraries:true \ dynamic profile:a qbs.buildVariant:release project.useStaticLibraries:false [ChangeLog] Each build configuration now requires a unique name, which is specified on the command line in the same place that qbs.buildVariant used to be specified. This allows building for multiple configurations with the same variant. Change-Id: I96ab9fc96861ab7e6a04a7d291a093115c22010e Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com> Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Jake Petroules <jake.petroules@qt.io> Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
* | Merge 1.5 into master.Christian Kandeler2016-06-171-2/+10
|\| | | | | | | Change-Id: I93e4943cf8112ce1088c34a43928d2133bc7dca7
| * Docs: Clarify the connection between file tags, rules and product type.Christian Kandeler2016-06-161-2/+4
| | | | | | | | | | | | Task-number: QBS-984 Change-Id: I4324e387ec4124f3f5f638ab8d627fc33f6f21a9 Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
| * Doc: Show syntax for multiple filesKai Koehne2016-06-121-0/+6
| | | | | | | | | | | | Change-Id: I3a2361865036573237f1f87e2967f149bbf218f2 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Jake Petroules <jake.petroules@qt.io>
* | Merge remote-tracking branch 'origin/1.5'Joerg Bornemann2016-06-081-5/+5
|\| | | | | | | | | | | | | | | Conflicts: doc/reference/items/transformer.qdoc share/qbs/modules/cpp/GenericGCC.qbs Change-Id: I45560834560019b18274c373c45651eb8aadd206
| * Replace 'the Qt build suite' with 'Qbs' in copyright notices.Jake Petroules2016-06-061-1/+1
| | | | | | | | | | | | Change-Id: I885d94bb14b325dc36767a840ebdb0be1fb59dd2 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
| * Avoid using the term "Qt Build Suite" in Qbs documentation.Jake Petroules2016-06-041-4/+4
| | | | | | | | | | | | | | | | | | This term is not used by anyone (it's always written as "Qbs" and pronounced "cubes") and it is ultimately confusing to users and detracts from the identity of the product, especially its pronunciation. Change-Id: Ifb76d059cafc33ce3fa686ddb3d7d67f47084faf Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
* | Bump required Qt version to 5.4.0Orgad Shaneh2016-06-061-7/+1
|/ | | | | | | | | | | Required for using new functions of QTimer. Get rid of workarounds and helper functions that support previous versions. Change-Id: I13bec075ce3014083120834a402bdc213df10be9 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com>
* Doc: Align code snippetsKai Koehne2016-05-181-1/+2
| | | | | | Change-Id: Id543798e8c00840504116d9077288327ab0f6543 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Jake Petroules <jake.petroules@qt.io>
* Doc: Remove mentioning of 'lighthouse'v1.4.4Kai Koehne2015-11-251-2/+2
| | | | | | | | | | Lighthouse was an internal name, it's now called QPA. Anyhow, this reference adds nothing to the understanding of the section, so we can as well remove it. Change-Id: I92808069a70d75a0ef9741566e0f9bc3b746231d Reviewed-by: Joerg Bornemann <joerg.bornemann@theqtcompany.com> Reviewed-by: Leena Miettinen <riitta-leena.miettinen@theqtcompany.com>
* Doc: Reformulate sentence in tutorial about explicit dependenciesKai Koehne2015-11-251-2/+1
| | | | | | | | | Saying that you need to 'import' the dependency is unfortunate, since import has been introduced with a very distinct meaning (QML imports). Change-Id: I59216cb651853eafb8169966cd6b23cee3201268 Reviewed-by: Joerg Bornemann <joerg.bornemann@theqtcompany.com>
* Solve the Java dependency tracking issue once and for all.Jake Petroules2015-07-091-1/+0
| | | | | | | | | | | | | | | | | | | This approach relies on the newly introduced ability of Modules to contain Groups, which may add additional source files to a Product. In the case of the Java module, the module includes a group which adds some sources to build a helper tool on-demand for each product that builds Java source code. This deviates from the previous approach of supplying a single jar for the entire qbs distribution and is thus somewhat less efficient, but is not expected to be a critical issue in the short term. To start, it solves two critical issues: the build-time dependency on javac, which complicates the qbs build process unnecessarily, and the bootstrap class path warning due to targeting Java 1.6 with newer JDKs. Change-Id: I533214a5d37fd69a4d8bfcf0db36bc7dae821d5f Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com>
* Add support for tracking class, h files produced by Java inner classes.Jake Petroules2015-05-281-0/+1
| | | | | | | | | | This also resolves the "perfect parsing" issue and so determining output file paths for Java class files won't be fooled by comments, etc. Feel free to use NULLs, unpaired surrogates, emoji, etc! Task-number: QBS-228 Change-Id: I3576a9a8e51a717ab8159db35f1a01e3ad91df88 Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com>
* Update links from qt-project.org to qt.ioSergio Ahumada2015-03-031-1/+1
| | | | | Change-Id: Iffe5f1dc07fac4db4970fa9ad871cd7ccfffffb0 Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com>
* update license headersJoerg Bornemann2015-03-021-2/+2
| | | | | Change-Id: I36d825db3a5ef32c162c3063aab1e8a1f2696f4f Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com>
* Merge branch '1.3' into 'master'Christian Kandeler2015-01-281-6/+6
|\ | | | | | | | | | | | | | | | | Conflicts: doc/reference/jsextensions/jsextensions-general.qdoc src/lib/corelib/language/evaluatorscriptclass.cpp src/lib/corelib/language/evaluatorscriptclass.h Change-Id: Ic9b77b56e8fc8bf93e0a553930757de8c93fed22
| * Update LicenseEike Ziller2015-01-261-6/+6
| | | | | | | | | | Change-Id: I092fca9f950de1ba38826c33b155f86feae2770b Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com>
* | Do installation at build time.Joerg Bornemann2015-01-081-4/+3
| | | | | | | | | | | | | | | | | | | | | | This is useful for e.g. "packaging products" that work on the contents of installation folders. For this purpose, we also expose the install root as a property in the qbs module. Opt-out is available, and the "install" command still works. Change-Id: I346a8e6d19fc24b38660201b1f6fa510acc6676c Reviewed-by: Jake Petroules <jake.petroules@petroules.com>
* | remove support for building qbs with Qt <= 5.1.0Joerg Bornemann2014-10-291-1/+1
| | | | | | | | | | Change-Id: I058eedd2d9dcaad1eaac1f4407f4f698133a774b Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* | remove qbs.getHostOS()Joerg Bornemann2014-10-291-0/+2
| | | | | | | | | | | | | | | | The weird hostOS: getHostOS() indirection isn't needed anymore. I'm feeling lucky, therefore I claim that nobody used getHostOS(). Change-Id: I77f365ec2d736b0c37ce979da761f9f9ae250a31 Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* | Merge remote-tracking branch 'origin/1.3'Joerg Bornemann2014-10-161-7/+8
|\| | | | | | | | | | | | | | | Conflicts: qbs_version.pri version.js Change-Id: I645b2f37bae9d36d4bca54b267d57df8b0b7fd21
| * complete license header updateJoerg Bornemann2014-10-161-7/+8
| | | | | | | | | | Change-Id: I2c7ea3242e5ce244e8feee01c0f8a0b0651fa0d4 Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* | Merge branch '1.3' into master.Christian Kandeler2014-09-111-1/+72
|\| | | | | | | | | | | | | | | | | | | Conflicts: qbs_version.pri src/app/qbs/commandlinefrontend.cpp src/lib/corelib/language/projectresolver.cpp version.js Change-Id: I6b8a09faed7970821955ac329b0c244ddffb037c
| * Add documentation about how to use custom modules.Christian Kandeler2014-09-081-1/+72
| | | | | | | | | | | | | | | | | | | | We don't explain this anywhere at the moment, and users would very much like to know. Change-Id: Icf7c81d5931f1154d8a6fd978b8cfe5054180b4b Reviewed-by: Jake Petroules <jake.petroules@petroules.com> Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com> Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>
* | Make qmake CONFIG value names consistent.Christian Kandeler2014-08-151-2/+2
|/ | | | | | | | By giving them all the "qbs" prefix. This also reduces the risk of clashes with values from other sources. Change-Id: I9406edccbc813e4759c840e17cf07926ae86a2d4 Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* Doc: remove outdated informationJoerg Bornemann2014-07-231-30/+0
| | | | | | | The setup-qt tool does more magic these days. Change-Id: I720a9421c5dc831d2e861d982875ac2e613fa605 Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* Doc: document qbs_enable_project_file_updatesJoerg Bornemann2014-07-211-0/+2
| | | | | | Change-Id: I1bc53e14219acec3ee9b3b88720bef25609e0a1b Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com> Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* prohibit duplicate source files in enabled groupsJoerg Bornemann2014-07-101-3/+3
| | | | | | | | | | Having the same source files in more than one enabled group is considered an error. There's no proper way to define conflict resolution rules. Task-number: QBS-593 Change-Id: I93d25b7e3484ce3a4da4e10299e1a3bf10951ca2 Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* Update references to the toolchain setup tool.Christian Kandeler2014-02-131-1/+1
| | | | | | | s/detect/setup Change-Id: If9d84c94c89c887fb833540a0e2c9d0da4919ba9 Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* Doc: extend build command documentationJoerg Bornemann2014-02-121-7/+19
| | | | | Change-Id: I35b561fbd1fbbc2ccb71656578dddd1d35ac56a9 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>
* Merge remote-tracking branch 'origin/1.1'Joerg Bornemann2014-01-091-1/+1
|\ | | | | | | Change-Id: Iccf01f1dad3fca4a78c7d9b795fdef6df0181e9b
| * Incremented year in copyright infoRobert Loehning2014-01-081-1/+1
| | | | | | | | | | | | Change-Id: Ib7f9a00bb891fa39c5bc1f891ddbfba1e4d23227 Reviewed-by: Jake Petroules <jake.petroules@petroules.com> Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* | Doc: Use the \QBS macro for the product nameLeena Miettinen2013-11-111-39/+39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This ensures that the name is always written in the same way and makes it easy to change, as only the value of the macro needs to be changed. Removed the product name from most titles as macros cannot be used in titles. It would break linking to titles. Please always use the macro in the future. Change-Id: I116abffc316edbb861034f5e431ca8e27b5a5d03 Reviewed-by: Jake Petroules <jake.petroules@petroules.com> Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* | Allow lists of patterns in the FileTagger item.Christian Kandeler2013-11-111-2/+2
|/ | | | | | | | | | | | Rationale: It is not uncommon that the same tag is associated with more than one file pattern; more common, in fact, than the other way around. It therefore seems silly to force module authors to create one FileTagger item per file extension. For semantic consistency, the "pattern" property gets renamed to "patterns". The old name is still supported in this minor version. Change-Id: Ia7f744b0903462517582fcb549e2dab004c81dd5 Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* Improve the documentation on building Qbs.Jake Petroules2013-10-211-7/+16
| | | | | | | | Now lists the recognized qmake CONFIG options. Change-Id: I183f97624566870e6b4d59d0c9e7f4fcb266e54f Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com> Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* A couple of small documentation improvements.Christian Kandeler2013-09-271-35/+35
| | | | | | | Remove outdated information, fix typos, add formatting etc. Change-Id: I98cdab3e39d719bdab5086640bb9f657eb2703f8 Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* Restructure the reference part of the documentation.Christian Kandeler2013-09-191-692/+0
| | | | | | | | | | It does not scale to repeat the whole contents of the reference manually in several tables of contents. Instead, make it opaque at the top-level and use the \group feature to get at least an automatic table of contents for the lowest level (items and modules at the moment). Change-Id: I80a3334a43f62481f74c21ad9d68e913c8b3098a Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* Rename Windows RT to WinRT. These terms have different meanings.Jake Petroules2013-07-251-1/+1
| | | | | | | In this context, we mean the Windows Runtime, not Windows on ARM. Change-Id: Iac76cb193b3b8040802105d8336282b8ee8f95e5 Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>
* introduce cpp.compilerWrapperJoerg Bornemann2013-07-021-0/+10
| | | | | | | Task-number: QBS-312 Change-Id: I516443a16d2d485f31bcfc1d646e9b38044a47b6 Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
* Re-introduce property qbs.installPrefix.Christian Kandeler2013-06-281-1/+11
| | | | | | | | | This property used to exist and was erroneously removed when the "install root" parameter was introduced. The author has now learned that "install prefix" and "install root" are actually orthogonal concepts. Change-Id: I8f704c92d09817063b82a175693899af9adc9bac Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>