Branches: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
(Merged edit from Eddy)
mNo edit summary
(31 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:Tools::Qt Creator:Branches]]
[[Category:Developing Qt::Process]]


All branches listed below reside in Gerrit on http://codereview.qt.io and are publicly available.
All branches listed below reside in Gerrit on http://codereview.qt.io and are publicly available.
* Anonymous checkout: <code>$ git clone http://code.qt.io/<project>/<repo></code>
* Anonymous checkout: <code>$ git clone http://code.qt.io/<project>/<repo></code>
* SSH (push to Gerrit): please check [[Setting up Gerrit]].
* SSH (push to Gerrit): please check [[Setting up Gerrit]].


= Qt 5 =
= Qt =
For the policy that describes the branches in Qt, which changes each branch may receive, and the process by which changes get from one branch to another, see  [http://quips-qt-io.herokuapp.com/quip-0016-branch-policy.html QUIP 16] and [[Branch Guidelines]].


== Mainline branches ==
== Mainline branches ==


dev, the current stable branch (5.5 as of Mar '15), and a possibly existing current release branch follow the [[Branch Guidelines]].
;dev: on-going development of new features and Qt 6 (as of 01/11/2019), and all bug fixes that are not only relevant for Qt 5 (as of 15/05/2020). All other branches typically receive only cherry-picks from dev.
;''stabilizing'': branch receiving bug-fixes for next minor release (5.15 as of 27/01/2020).
;''stable'': stabilized branch still receiving bug-fixes (e.g 5.14 until 27/04/2020, on which date that branch was closed). Stable and stabilizing branches may receive commits that are not cherry-picks from dev, if the respective patch is not relevant for the dev branch.
;''LTS'': Long-Term Support, 5.9 (May 31st 2020) and 5.12 (December 6th 2021), only taking critical fixes.
;''LTS/release'': receiving LTS release-critical bug-fixes (e.g. 5.12.6 as of 01/11/2019). Changes made here as part of a release (such as changes files) need to be cherry-picked forward into the stable branch and into dev.


== Other branches ==
== Other branches ==


Used for research or development of complex features.<br/>
* Used for research or development of complex features.
Feature branch names should be prefixed with wip/. Exceptions are historical.<br/>
* Feature branch names should be prefixed with wip/. Exceptions are historical.
Feature branches often have relaxed review and integration policies and may be subject to occasional rebasing.
* Feature branches often have relaxed review and integration policies and may be subject to occasional rebasing.


The following branch list applies to qt/qtbase unless otherwise noted.
The following branch list applies to qt/qtbase unless otherwise noted.
;wip/lite: Qt Lite, a project to make it possible at configure-time to opt out of parts of the tool-kit that a particular delivery doesn't need (thereby saving space on bitty little devices).
;wip/network-test-server: Development of a containerised local implementation of the server used by qtbase's network tests.  Uses a vagrant container.  (Inactive since 2015/Oct; but network team does hope to find time to revive it.)
;wip/nacl: Present in qtbase, qtdeclarative.  A Qt port for the Google (portable) Native Client, and emscripten.
;wip/qbs: A new Qt Build System.
;winrt: (misnomer, should be wip/winrt) Present in qtbase, qttools.
: Used for development of Qt's Windows Runtime port (see http://blog.qt.io/blog/2013/02/15/port-to-windows-runtime-kick-started/ and http://blog.qt.io/blog/2013/04/19/qts-winrt-port-and-its-ccx-usage/ for some background information). Gerrit is enabled for this branch but it is not CI checked. Be aware, that this branch is rebased regularly (force pushes involved). If you want to get in contact/help out, join #qt-winrt on freenode.
;wip/mir: Development history for ''src/plugins/platforms/mirclient/''. Fully merged into Qt 5.6 by https://codereview.qt-project.org/#/c/122984
: No longer active, but Canonical have said (2016-08-22, on developer list):
:: We're iterating the code in our repository (lp:qtmir) but plan to update this wip branch once we're happy with the features and apis


=== ios (misnomer, should be wip/ios) ===
=== Dead branches ===
 
=== wip/qstring-utf8 ===
 
Dead branch, merged long ago: was used to convert the QString functions that take const char* from Latin1 to UTF-8.
 
=== winrt (misnomer, should be wip/winrt) ===
 
Used for development of Qt's Windows Runtime port (see http://blog.qt.io/blog/2013/02/15/port-to-windows-runtime-kick-started/ and http://blog.qt.io/blog/2013/04/19/qts-winrt-port-and-its-ccx-usage/ for some background information). Gerrit is enabled for this branch but it is not CI checked. Be aware, that this branch is rebased regularly (force pushes involved). If you want to get in contact/help out, join #qt-winrt on freenode.
 
=== wip/tizen (base+declarative+quickcontrols+…) ===
 
=== wip/network-test-server ===
 
Development of a containerised local implementation of the server used by qtbase's network tests.
Uses a vagrant container.
 
=== wip/highdpi ===
High-DPI research for Qt 5.6. Not in use.
 
=== wip/lite ===
 
Qt Lite, a project to make it possible at configure-time to opt out of parts of the tool-kit that a particular delivery doesn't need (thereby saving space on bitty little devices).
 
=== wip/mir ===
 
=== wip/nacl ===
 
Presumably integration for the [https://nacl.cr.yp.to/ Networking and Cryptography Library] (NaCl), in place of OpenSSL and its equivalents.
 
A Qt port fort Google (portable) Native Client, and emscripten.
 
=== wip/qbs ===
 
A new Qt Build System.
 
 
= Qt 4 =
 
== Mainline branches ==
 
The 4.8 branch follows the [[Branch Guidelines]].
 
== Other branches ==
 
=== 4.8-bb10 ===


This branch contains a recent version of the 4.8 branch plus additional backported patches that are used for BlackBerry 10 and are not backported to the 4.8 branch. The 4.8-bb10 branch is subject to rebasing.
;wip/highdpi: High-DPI research for Qt 5.6.  No longer in use (last commit: 2015/Jul).
;wip/tizen: Present in qtbase, qtdeclarative, qtsensors and qtquickcontrols.
: Branch abandoned (RIP 2015/Feb); apparently for want of enthusiastic developers.
: Relates to support for [https://en.wikipedia.org/wiki/Tizen Tizen], a GNU/Linux operating system for low-end devices.  See: http://qtfortizen.blogspot.co.uk/
;wip/qstring-utf8: Dead branch, merged long ago (c. 2012/May). Was used to convert the QString functions that take const char* from Latin1 to UTF-8.


= Qt Creator =
= Qt Creator =


See [[Submit-Policies]] for Qt Creator's branching policy.
See [[Qt Creator Submission Policies|Submit-Policies]] for Qt Creator's branching policy.


=== wip/vcproj ===
=== wip/vcproj ===


Branch used to develop a plugin that enables people to work with Visual Studio projects in Qt Creator. Currently it can only open projects with a .vcproj extension.
Branch used to develop a plugin that enables people to work with Visual Studio projects in Qt Creator. Currently it can only open projects with a <kbd>.vcproj</kbd> extension.
* At the moment plugin supports:
* At the moment plugin supports:
** editing of project's properties (this feature waits for a code review on Gerrit)
** editing of project's properties (this feature waits for a code review on Gerrit)

Revision as of 14:26, 15 May 2020


All branches listed below reside in Gerrit on http://codereview.qt.io and are publicly available.

  • Anonymous checkout:
    $ git clone http://code.qt.io/<project>/<repo>
    
  • SSH (push to Gerrit): please check Setting up Gerrit.

Qt

For the policy that describes the branches in Qt, which changes each branch may receive, and the process by which changes get from one branch to another, see QUIP 16 and Branch Guidelines.

Mainline branches

dev
on-going development of new features and Qt 6 (as of 01/11/2019), and all bug fixes that are not only relevant for Qt 5 (as of 15/05/2020). All other branches typically receive only cherry-picks from dev.
stabilizing
branch receiving bug-fixes for next minor release (5.15 as of 27/01/2020).
stable
stabilized branch still receiving bug-fixes (e.g 5.14 until 27/04/2020, on which date that branch was closed). Stable and stabilizing branches may receive commits that are not cherry-picks from dev, if the respective patch is not relevant for the dev branch.
LTS
Long-Term Support, 5.9 (May 31st 2020) and 5.12 (December 6th 2021), only taking critical fixes.
LTS/release
receiving LTS release-critical bug-fixes (e.g. 5.12.6 as of 01/11/2019). Changes made here as part of a release (such as changes files) need to be cherry-picked forward into the stable branch and into dev.

Other branches

  • Used for research or development of complex features.
  • Feature branch names should be prefixed with wip/. Exceptions are historical.
  • Feature branches often have relaxed review and integration policies and may be subject to occasional rebasing.

The following branch list applies to qt/qtbase unless otherwise noted.

wip/lite
Qt Lite, a project to make it possible at configure-time to opt out of parts of the tool-kit that a particular delivery doesn't need (thereby saving space on bitty little devices).
wip/network-test-server
Development of a containerised local implementation of the server used by qtbase's network tests. Uses a vagrant container. (Inactive since 2015/Oct; but network team does hope to find time to revive it.)
wip/nacl
Present in qtbase, qtdeclarative. A Qt port for the Google (portable) Native Client, and emscripten.
wip/qbs
A new Qt Build System.
winrt
(misnomer, should be wip/winrt) Present in qtbase, qttools.
Used for development of Qt's Windows Runtime port (see http://blog.qt.io/blog/2013/02/15/port-to-windows-runtime-kick-started/ and http://blog.qt.io/blog/2013/04/19/qts-winrt-port-and-its-ccx-usage/ for some background information). Gerrit is enabled for this branch but it is not CI checked. Be aware, that this branch is rebased regularly (force pushes involved). If you want to get in contact/help out, join #qt-winrt on freenode.
wip/mir
Development history for src/plugins/platforms/mirclient/. Fully merged into Qt 5.6 by https://codereview.qt-project.org/#/c/122984
No longer active, but Canonical have said (2016-08-22, on developer list):
We're iterating the code in our repository (lp:qtmir) but plan to update this wip branch once we're happy with the features and apis

Dead branches

wip/highdpi
High-DPI research for Qt 5.6. No longer in use (last commit: 2015/Jul).
wip/tizen
Present in qtbase, qtdeclarative, qtsensors and qtquickcontrols.
Branch abandoned (RIP 2015/Feb); apparently for want of enthusiastic developers.
Relates to support for Tizen, a GNU/Linux operating system for low-end devices. See: http://qtfortizen.blogspot.co.uk/
wip/qstring-utf8
Dead branch, merged long ago (c. 2012/May). Was used to convert the QString functions that take const char* from Latin1 to UTF-8.

Qt Creator

See Submit-Policies for Qt Creator's branching policy.

wip/vcproj

Branch used to develop a plugin that enables people to work with Visual Studio projects in Qt Creator. Currently it can only open projects with a .vcproj extension.

  • At the moment plugin supports:
    • editing of project's properties (this feature waits for a code review on Gerrit)
    • adding/removing files, filters and folders to/from a project (also waits for a code review on Gerrit).
    • building a Visual Studio (.vcproj) project
  • How to set up